# Claude Code 接入

## 配置 Claude Code

将以下字段合并到用户配置 `~/.claude/settings.json`：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-cr-gateway.example",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_OPUS_MODEL",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_SONNET_MODEL",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_FAST_MODEL"
  },
  "model": "sonnet"
}
```

三个 `YOUR_*_MODEL` 值都是模型名称。设置认证变量并启动 Claude Code：

```bash
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude
```

## 启动并验证

1. 启动 Claude Code，然后运行 `/status`，确认当前模型。
2. 完成一个短任务，验证流式输出和一次工具调用。
3. 如果请求失败，按[排障与重试](/docs/zh/troubleshooting)保留状态码、模型名称和 CR 请求 ID。

## Claude Code 配置约束

- `settings.json` 是标准 JSON，不能包含注释。合并现有 `env`，不要覆盖其他配置。
- `ANTHROPIC_BASE_URL` 只填写 HTTPS API Base URL，不追加 API 路径。
- 只有模型详情明确支持 1M 上下文时，才可在 `ANTHROPIC_DEFAULT_OPUS_MODEL` 或 `ANTHROPIC_DEFAULT_SONNET_MODEL` 的值后追加 `[1m]`；不要用于 `ANTHROPIC_DEFAULT_HAIKU_MODEL`。