Claude Code란
Claude Code는 코드베이스 읽기, 파일 편집, 명령 실행, 개발 도구 통합을 위한 Anthropic의 에이전틱 코딩 도구입니다. 이 구성은 Claude Code의 게이트웨이 설정인 API 엔드포인트, 인증 토큰, 별칭별 모델을 지정해 Claude Code가 Capriole AI를 사용하게 합니다. Claude Pro나 Max로 로그인한 Claude Code는 플랜의 5시간 및 주간 사용량 한도를 쓰지만, Capriole AI API 키를 쓰면 API 토큰 잔액을 사용합니다.사전 준비
시작하기 전에 다음이 있는지 확인하세요.- Capriole AI 계정(여기에서 가입)
- Premium 플랜(월 USD 9, 무제한 웹 채팅 포함) 또는 Team 플랜. API 키를 만들려면 둘 중 하나가 필요합니다(구독하기)
- Capriole AI API 키(키 받기)
설치
공식 네이티브 설치 프로그램으로 Claude Code를 설치하세요.구성
모델 검증
Claude Code 2.1.304 버전은 아래 구성으로 지원 모델 섹션의 모든 모델에서 Capriole AI를 통한 파일 읽기, 파일 쓰기, 최종 답변 검사를 통과합니다.~/.claude/settings.json을 만들거나 업데이트하세요.
model은 새 세션의 기본 모델입니다./model로 선택한 모델은 저장되어 다음에도 사용됩니다.ANTHROPIC_BASE_URL은 요청을 Capriole AI로 보냅니다./v1을 추가하지 마세요. Claude Code가/v1/messages를 직접 추가합니다.ANTHROPIC_AUTH_TOKEN은 키를 Capriole AI가 요구하는 Bearer 토큰으로 보냅니다.- 세 개의
ANTHROPIC_DEFAULT_*_MODEL값은opus,sonnet,haiku별칭이 Capriole AI가 제공하는 모델을 가리키게 합니다.haiku는 Claude Code가 빠른 백그라운드 작업에 사용하는 모델입니다.
Claude Code 실행
프로젝트 디렉터리에서 Claude Code를 시작하세요./model로 모델을 전환하세요. 예를 들어 Opus 5.5를 쓰려면 /model opus를 입력합니다. 비대화형으로 실행하려면 print 모드를 사용하세요.
지원 모델
Claude Code는 Anthropic Messages 프로토콜을 사용하므로 Capriole AI의 Claude 모델을 지원합니다.claude-fable-5-1(Fable 5.1, 권장 기본값)claude-opus-5-5(Opus 5.5)claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-4-6claude-latest: 항상 최신 Claude 플래그십 모델을 가리킵니다(현재 Fable 5.1).
claude-latest를 모델 이름으로 인식하지 못해 200K 컨텍스트 창을 가정합니다. 모델의 전체 컨텍스트 창을 사용하려면 claude-fable-5-1 같은 구체적인 ID를 사용하세요.
문제 해결
Claude Code가 인증 오류를 반환하는 이유는 무엇인가요?
ANTHROPIC_AUTH_TOKEN을 사용하면 Claude Code가 Authorization 헤더에 Capriole AI 키를 Bearer 토큰으로 보냅니다.
요청이 엔드포인트 오류로 실패하는 이유는 무엇인가요?
ANTHROPIC_BASE_URL이 /v1 없는 https://api.caprioletech.com인지 확인하세요.
Claude Code가 실행할 때마다 다른 모델로 돌아가는 이유는 무엇인가요?
설정과 셸에서ANTHROPIC_MODEL을 제거하세요. 이 값이 설정되어 있으면 Claude Code는 다음 실행 시 /model로 저장한 모델 대신 이 모델로 돌아갑니다.
/model opus 또는 /model sonnet이 실패하는 이유는 무엇인가요?
ANTHROPIC_DEFAULT_*_MODEL 값 3개를 유지하면 Claude Code의 별칭이 Capriole AI에 설정한 Claude 모델에 연결됩니다.
Claude Code가 내가 설정한 추론 강도를 사용하지 않는 이유는 무엇인가요?
Claude Code는 모델마다 추론 강도를 따로 저장합니다. 해당 모델이 활성화된 상태에서/effort로 선택하세요. 사용자 설정의 최상위 effortLevel은 Opus 5.5에 적용되지 않습니다.
토큰 계산이 실패하는 이유는 무엇인가요?
Capriole AI는/v1/messages/count_tokens를 선택된 업스트림으로 전달합니다. 해당 업스트림이 토큰 계산을 지원하지 않으면 Claude Code가 대신 토큰 수를 추정하며, 세션은 계속 작동합니다.
참고
~/.claude/settings.json은 모든 프로젝트에서 사용자 계정에 적용됩니다.YOUR_CAPRIOLE_AI_API_KEY를 Capriole AI API 키로 바꾸세요.- Claude Code는 Anthropic Messages를 통해 Claude 모델을 사용합니다. Gemini, Grok, GLM, Kimi에는 OpenCode나 Kilo Code처럼 여러 프로토콜을 지원하는 에이전트를 사용하세요.
- 같은 키를 다른 코딩 에이전트에서도 쓰려면 코딩 에이전트에 API 키 하나 사용하기 가이드를 참고하세요.
- 공식 참고: Claude Code 설치 및 설정, 모델 구성, LLM 게이트웨이 구성.

