API Gateway/연동 가이드/Claude Code

Claude Code CLI 연동

Anthropic의 공식 AI 코딩 도우미 Claude Code를 팩트챗 Gateway와 함께 사용해보세요!

환경 변수 2개만 설정하면 Claude Code의 모든 기능을 Gateway를 통해 사용할 수 있습니다. 스트리밍, 도구 사용, 확장 사고 등 모든 Anthropic 기능이 완벽하게 지원됩니다.

공식 문서: Claude Code
VS Code 확장 사용법: VS Code에서 Claude Code 사용하기
모델 선택 설정: 모델 구성

시작하기 전에 팩트챗 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.

설정

왜 ANTHROPIC_API_KEY가 아닌 ANTHROPIC_AUTH_TOKEN인가요?

영구 설정

~/.zshrc 또는 ~/.bashrc에 추가:

또는 프로젝트에 .env 파일 생성:

모델 지정

호출 가능한 모델 목록은 Gateway에서 직접 확인합니다.

이 목록은 기관 설정과 멤버 그룹 권한에 따라 계정마다 다릅니다. 여기에 보이는 모델 ID는 그대로 --model이나 ANTHROPIC_MODEL에 넣어 쓸 수 있습니다.

VS Code 확장에서 사용하기

VS Code의 Claude Code 확장도 같은 환경 변수를 씁니다. 프로젝트의 .vscode/settings.json 대신 Claude Code 설정 파일(~/.claude/settings.json 또는 프로젝트의 .claude/settings.json)의 env 항목에 넣으면 확장과 CLI가 같은 설정을 공유합니다.

설정을 바꾼 뒤에는 VS Code 창을 다시 로드해야 확장이 새 값을 읽습니다 (명령 팔레트 → Developer: Reload Window).

모델 선택 화면에 원하는 모델이 안 보일 때

모델 선택 목록(/model)에는 Claude Code가 서버로부터 "사용 가능"을 확인한 모델만 올라옵니다. Gateway를 통해 연결하면 그 확인 절차를 거치지 않는 모델이 있어, 호출은 되는데 목록에는 안 보이는 경우가 생깁니다. Claude Fable 5가 대표적입니다.

목록에 없어도 아래 방법으로 선택하면 그대로 호출됩니다.

채팅창에서 /model fable 입력 — 목록에 없어도 선택됩니다
위 설정처럼 ANTHROPIC_MODEL에 모델 ID를 직접 지정
fable 별칭이 가리키는 모델을 바꾸려면 ANTHROPIC_DEFAULT_FABLE_MODEL을 claude-fable-5로 지정

실제로 어떤 모델이 응답했는지는 응답의 model 필드로 확인하실 수 있습니다.

Claude Fable 5는 Claude Code v2.1.170 이상에서만 선택할 수 있습니다. 그 이전 버전은 목록에 표시되지 않고 선택도 되지 않습니다. PC마다 동작이 다르다면 VS Code 확장 탭에서 Claude Code 확장을 최신으로 업데이트해 주십시오.

확장 자체 사용법

확장 설치, 단축키, @ 파일 참조, 플러그인 관리 등은 Anthropic 공식 문서에 정리돼 있습니다. 한국어판이 제공됩니다.

VS Code에서 Claude Code 사용하기: https://code.claude.com/docs/ko/vs-code
모델 구성(/model, 모델 별칭, 환경 변수): https://code.claude.com/docs/ko/model-config
설정 파일(settings.json, env 블록): https://code.claude.com/docs/ko/settings

확장은 CLI 복사본을 자체적으로 포함하고 있어, 터미널의 claude 버전과 확장이 쓰는 버전이 다를 수 있습니다.

지원 기능

기능	지원 여부
스트리밍 응답	지원
도구 사용 (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

OpenAI SDK

Codex CLI