Claude Code 接入

最小配置

在 Claude Code 的用户级 settings.json 中配置环境变量。Windows 通常位于 %USERPROFILE%\.claude\settings.json，macOS / Linux 位于 ~/.claude/settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dingjiai.com",
    "ANTHROPIC_API_KEY": "sk-你的顶级AI用户APIKey",
    "ANTHROPIC_MODEL": "从 Anthropic 模型列表复制的 public model id",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "同一个或对应的 Anthropic public model id",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "同一个或对应的 Anthropic public model id",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "同一个或对应的 Anthropic public model id"
  }
}

只有一个已发布的 Anthropic public model id 时，可以先把四个模型变量都映射到它；有多个已发布模型时，再分别映射 Haiku、Sonnet 和 Opus。

• ANTHROPIC_MODEL 设置主会话模型。
• ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 分别决定 haiku、sonnet、opus 别名解析到哪个模型；它们不是“所有请求都强制用这个模型”的开关。Haiku 槽位还用于 Claude Code 的轻量后台功能。
• 子代理单独解析模型：CLAUDE_CODE_SUBAGENT_MODEL 若设置为模型名或别名，优先级最高；否则依次看本次 Agent 调用的 model 参数、agent 定义中的 model，最后继承主会话模型。agent 的 model: inherit 或省略 model 都表示正常继承；新版中把 CLAUDE_CODE_SUBAGENT_MODEL 设为 inherit 也等同于不设置。

上方 JSON 示例中的四个 ANTHROPIC_*MODEL 映射值都必须是当前网关 Anthropic 模型列表中已发布的 public model id。CLAUDE_CODE_SUBAGENT_MODEL 是独立规则：可以填写网关支持的完整模型 ID 或 Claude Code alias，也可以用 inherit 恢复正常的逐级解析。

模型列表

curl https://dingjiai.com/anthropic/v1/models \
  -H "x-api-key: YOUR_USER_API_KEY" \
  -H "anthropic-version: 2023-06-01"

把返回的 public model id 填入 ANTHROPIC_MODEL。OpenAI 或 Gemini 列表中的同名模型不自动代表 Anthropic Messages 可用。

首次启用与验证

1. 完全退出并重新启动 Claude Code。
2. 若仍停在登录页，说明 Claude Code 没有加载到这组本机凭据；此时还不能运行 /config。退出客户端，检查 settings.json 路径、JSON 语法、文件权限和 Key 后再启动；需要登录选择时只使用 Claude Code 当前公开支持的流程。
3. 只有已经进入会话、但自定义 Key 未批准、被拒绝或仍使用旧账号时，才运行 /config 并选择 Use custom API key，然后重启客户端。不要依赖未公开的内部凭据 hack。
4. 运行 /status，确认 Base URL、认证方式和当前模型均指向本页配置；若仍显示旧账号或旧地址，先按 Claude Code 当前官方登录流程退出冲突登录，再重新选择 custom API key。
5. 发送一条最小请求，确认使用的是 Anthropic 模型列表中已发布的 public model id。

Claude Code 版本与登录交互会更新；模型槽位和子代理优先级以 Claude Code model configuration、subagents 和 LLM gateway configuration 为准。

接口验证

curl https://dingjiai.com/v1/messages \
  -H "x-api-key: YOUR_USER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从 Anthropic 模型列表复制的 public model id",
    "max_tokens": 256,
    "messages": [{"role":"user","content":"你好"}]
  }'

• 每位用户使用自己的顶级AI用户 API Key，不得填写上游 provider Key。
• API Key 会保存在本机配置中，不要提交到 Git 或发给他人。
• anthropic-version 可保留客户端默认值；它不是选择上游版本的开关。