# Claude Code 接入指南

## 基础信息

- 接入地址：`https://api.apiverse.ai/v1/support/claudeCode`
- API Key：控制台「API 密钥」页面创建，需开通「大模型」能力

## 快速配置

编辑 `~/.claude/settings.json`：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<API_KEY>",
    "ANTHROPIC_BASE_URL": "https://api.apiverse.ai/v1/support/claudeCode",
    "API_TIMEOUT_MS": "600000",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 64000,
    "ANTHROPIC_MODEL": "global.anthropic.claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "global.anthropic.claude-haiku-4-5-20251001-v1:0",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "global.anthropic.claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "global.anthropic.claude-opus-5"
  },
  "permissions": {
    "defaultMode": "default"
  },
  "model": "opus"
}
```

各 `ANTHROPIC_*_MODEL` 的可选值见「Claude 系列 API 对接文档」中的模型参数列。

## 在 Claude Code 中使用 GPT 和 DeepSeek 模型

**本平台的一项独特能力**：Claude Code 默认只支持 Claude 系列，但通过本平台的协议转换层，你可以直接在 Claude Code 里调用 GPT 和 DeepSeek 模型，无需切换工具或额外配置。

在 `settings.json` 的 `env` 中把 `ANTHROPIC_MODEL` 换成下表任意一个模型参数即可。

### GPT 系列（在 Claude Code 中可用）

| 模型 | 模型参数（model） |
| ---- | ---- |
| GPT-5.6 Terra | gpt-5.6-terra[1m] |
| GPT-5.6 Sol | gpt-5.6-sol[1m] |
| GPT-5.6 Luna | gpt-5.6-luna[1m] |
| GPT-5.5 | gpt-5.5[1m] |

### DeepSeek 系列（在 Claude Code 中可用）

| 模型 | 模型参数（model） |
| ---- | ---- |
| DeepSeek V4 Pro | deepseek-v4-pro[1m] |
| DeepSeek V4 Pro 0813 | deepseek-v4-pro-0813[1m] |
| DeepSeek V4 Flash | deepseek-v4-flash[1m] |
| DeepSeek V4 Flash 0731 | deepseek-v4-flash-0731[1m] |

> 上述模型也同样支持 `ANTHROPIC_DEFAULT_SONNET_MODEL` / `ANTHROPIC_DEFAULT_OPUS_MODEL` 等字段，可按需混搭不同系列。完整模型清单以控制台「模型广场」为准。

模型参数末尾的 `[1m]` 表示使用 1M 上下文窗口，需一并传入。命令行指定模型示例：

```bash
claude --model "deepseek-v4-pro-0813[1m]"
claude --model "gpt-5.6-sol[1m]"
```

## Windows 补充配置

macOS / Linux 用户无需此步骤。Windows 需修改 `C:\Users\<用户名>\.claude.json`，加入下面这一行后保存并重启编辑器：

```json
"hasCompletedOnboarding": true
```

## JetBrains

JetBrains 系 IDE 建议使用官方 Claude Code 插件接入，兼容性更好。插件安装后按上述 `settings.json` 配置即可。

## 常见问题

| 现象 | 排查方向 |
| ---- | -------- |
| 返回 403 未开通 LLM 能力 | 在控制台重新创建并开通「大模型」能力的 API Key |
| 模型返回 503 / 排队 | 换用同系列其他模型，或联系技术支持 |
| 返回 666 | 复制响应体 `code_reason` 联系技术支持 |