Claude Code CLI 연동
Anthropic의 공식 AI 코딩 도우미 Claude Code를 팩트챗 Gateway와 함께 사용해보세요!
환경 변수 2개만 설정하면 Claude Code의 모든 기능을 Gateway를 통해 사용할 수 있습니다. 스트리밍, 도구 사용, 확장 사고 등 모든 Anthropic 기능이 완벽하게 지원됩니다.
- 공식 레퍼런스: Claude Code 문서
시작하기 전에 팩트챗 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.
설정
ANTHROPIC_BASE_URL이 설정되면 Claude Code는 ANTHROPIC_AUTH_TOKEN의 토큰을 x-api-key 헤더로 전송합니다. Gateway는 Authorization: Bearer와 x-api-key 헤더를 모두 지원하므로 원활하게 작동합니다. 실수로 ANTHROPIC_API_KEY를 사용하면 Claude Code가 커스텀 엔드포인트에 접근하기 전에 Anthropic 직접 검증을 시도하여 401 오류가 발생할 수 있습니다. 반드시 ANTHROPIC_AUTH_TOKEN을 사용해주세요.영구 설정
~/.zshrc 또는 ~/.bashrc에 추가:또는 프로젝트에
.env 파일 생성:모델 지정
지원 기능
| 기능 | 지원 여부 |
|---|---|
| 스트리밍 응답 | 지원 |
| 도구 사용 (function calling) | 지원 |
| 비전 (이미지 입력) | 지원 |
| 확장 사고 | 지원 |
| 프롬프트 캐싱 | 지원 |
| 다중 턴 대화 | 지원 |
트러블슈팅
401 Unauthorized
ANTHROPIC_API_KEY가 아닌ANTHROPIC_AUTH_TOKEN이 설정되어 있는지 확인- API 키가 유효한지 확인
모델을 찾을 수 없음 / 404
ANTHROPIC_BASE_URL이/v1/gateway/claude로 끝나는지 확인- SDK가 Base URL에
/v1/messages를 자동으로 추가합니다
Gateway 해제 (Anthropic 직접 연결로 복원)
마지막 수정 날짜: Apr 15, 2026