> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capriole.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Claude Code가 Capriole AI를 사용하도록 구성합니다.

## Claude Code란

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

## 사전 준비

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

* Capriole AI 계정([여기에서 가입](https://capriole.ai))
* Capriole AI API key([키 받기](https://capriole.ai?view=api))

## 설치

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

## 구성

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

```json theme={null}
{
  "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를 시작하기 전에 같은 값을 내보내세요.

```bash theme={null}
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를 시작하세요.

```bash theme={null}
claude
```

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

```bash theme={null}
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](https://code.claude.com/docs/en/setup), [environment variables](https://code.claude.com/docs/en/env-vars), [model configuration](https://code.claude.com/docs/en/model-config), [Claude effort](https://platform.claude.com/docs/en/build-with-claude/effort).