Claude Code - Capriole AI Docs

Claude Code란

Claude Code는 코드베이스 읽기, 파일 편집, 명령 실행, 개발 도구 통합을 위한 Anthropic의 에이전틱 코딩 도구입니다. 이 CLI 구성은 Claude Code의 API 엔드포인트, 인증 토큰, 모델 환경 변수를 설정해 Capriole AI를 사용합니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.

Capriole AI 계정(여기에서 가입)
Capriole AI API key(키 받기)

설치

npm install -g @anthropic-ai/claude-code

구성

지속 구성을 위해 ~/.claude/settings.json을 만들거나 업데이트하세요.

{
  "model": "claude-latest",
  "effortLevel": "high",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.caprioletech.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CAPRIOLE_AI_API_KEY",
    "ANTHROPIC_MODEL": "claude-latest",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-latest",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-latest",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-latest",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-latest",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-latest"
  }
}

일회성 셸 구성이면 Claude Code를 시작하기 전에 같은 값을 내보내세요.

export ANTHROPIC_BASE_URL="https://api.caprioletech.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_CAPRIOLE_AI_API_KEY"

export ANTHROPIC_MODEL="claude-latest"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-latest"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-latest"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-latest"
export ANTHROPIC_SMALL_FAST_MODEL="claude-latest"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-latest"

Claude Code 실행

~/.claude/settings.json을 저장하거나 변수를 내보낸 뒤, 프로젝트 디렉터리에서 Claude Code를 시작하세요.

claude

저장된 설정 파일 없이 일회성 비대화형 실행을 하려면 모델을 명시적으로 전달하세요.

claude --model claude-latest -p "Explain this repository."

지원 모델

Claude Code는 Capriole AI를 통해 Claude latest, Fable 5, Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6을 지원합니다. 새 구성에는 claude-latest를 사용하세요. Fable 5로 해석됩니다.

claude-latest
claude-fable-5
claude-opus-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6

문제 해결

Claude Code가 인증 오류를 반환하는 이유는 무엇인가요?

claude를 시작하기 전에 같은 셸에서 ANTHROPIC_AUTH_TOKEN을 내보냈는지 확인하세요. 이 구성에는 ANTHROPIC_API_KEY가 아니라 ANTHROPIC_AUTH_TOKEN을 사용하세요.

요청이 엔드포인트 오류로 실패하는 이유는 무엇인가요?

ANTHROPIC_BASE_URL이 /v1 없는 https://api.caprioletech.com인지 확인하세요. Claude Code는 /v1/messages와 /v1/messages/count_tokens로 요청을 보냅니다.

Claude Code가 Claude latest를 사용하지 않는 이유는 무엇인가요?

시작 전에 model, ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL, 기본 모델 환경 변수가 설정되어 있는지 확인한 다음, 활성 세션이나 설정 재정의가 있는지 /model 또는 /status로 확인하세요.

Claude Code가 구성한 effort level을 사용하지 않는 이유는 무엇인가요?

~/.claude/settings.json에 "effortLevel": "high"를 설정한 다음 Claude Code를 다시 시작하세요. Claude Code 설정은 low, medium, high, xhigh를 받으며 effortLevel에는 max가 허용되지 않습니다. 세션에서 절대 최대 effort가 필요하면 /effort max를 사용하거나 claude --effort max로 시작하거나, claude를 시작하기 전에 CLAUDE_CODE_EFFORT_LEVEL=max를 설정하세요.

Claude Code가 구체적인 Opus 모델을 선택하지 못하는 이유는 무엇인가요?

claude update로 Claude Code를 업데이트한 다음 claude --version을 실행하세요.

토큰 계산이나 시작 시 모델 검색이 실패하는 이유는 무엇인가요?

모델 환경 변수를 유지하고 모델 ID가 claude-latest 또는 지원되는 구체 Claude 모델 ID인지 확인하세요. Capriole AI는 /v1/messages/count_tokens를 선택한 업스트림으로 프록시하므로, 토큰 수 사전 검사는 해당 업스트림이 Anthropic token counting을 지원하는지에 따라 달라집니다.

참고

~/.claude/settings.json은 프로젝트 전반에 사용자 계정에 적용됩니다. YOUR_CAPRIOLE_AI_API_KEY를 자리 표시자로 두고 실제 Capriole AI API key로 바꾸세요.
ANTHROPIC_BASE_URL은 Claude Code가 요청을 보내는 위치를 바꿉니다. 모델 환경 변수는 전송되는 모델 ID를 제어합니다.
ANTHROPIC_SMALL_FAST_MODEL은 claude-latest와 같아야 Claude Code 보조 요청이 주 대화와 같은 Capriole AI latest 별칭을 사용합니다.
이 구성은 문서화된 기본 effort level로 high를 사용합니다. xhigh도 지속 effortLevel 옵션이며, max는 세션 수준 재정의로 더 많은 thinking 토큰을 사용할 수 있습니다.
공식 참고: Claude Code setup, environment variables, model configuration, Claude effort.

​Claude Code란

​사전 준비

​설치

​구성

​Claude Code 실행

​지원 모델

​문제 해결

​Claude Code가 인증 오류를 반환하는 이유는 무엇인가요?

​요청이 엔드포인트 오류로 실패하는 이유는 무엇인가요?

​Claude Code가 Claude latest를 사용하지 않는 이유는 무엇인가요?

​Claude Code가 구성한 effort level을 사용하지 않는 이유는 무엇인가요?

​Claude Code가 구체적인 Opus 모델을 선택하지 못하는 이유는 무엇인가요?

​토큰 계산이나 시작 시 모델 검색이 실패하는 이유는 무엇인가요?

​참고