Claude Code 自定义模型接入
查看该工具的安装、自定义模型配置和验证方法。
使用前准备
- 已安装 Claude Code CLI 或 Claude Code 桌面版。
- 已获取 API Base URL。
- 已在本站 API Key 管理 创建可用的 API Key。
- 已在本站 模型广场 查看并复制模型 ID。
- 明确当前服务是 Anthropic 兼容接口、Claude Code 第三方推理网关,还是通过中转服务转发。
- Windows 用户建议同时准备 CMD 和 PowerShell,便于测试环境变量是否生效。
配置说明
Claude Code 的配置方式与 OpenAI 兼容工具不同。CLI 通常使用
ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL
等环境变量或配置文件字段。
安装 Claude Code CLI
curl -fsSL https://claude.ai/install.sh | bashpowershell irm https://claude.ai/install.ps1 | iex curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd安装完成后,重新打开终端并检查是否可用:
claude --help配置 Claude Code CLI
2.1 使用配置文件配置API-KEY
推荐优先使用环境变量或配置文件方式。注意:下面的命令需要在系统终端中执行,不是在 Claude 聊天窗口中执行。
创建 Claude Code 配置目录:
mkdir -p ~/.claude编辑配置文件:
vim ~/.claude/settings.json写入以下内容:
{ "env": { "ANTHROPIC_AUTH_TOKEN": "${YOUR_API_KEY}", "ANTHROPIC_BASE_URL": "https://api.do.top/v1", "ANTHROPIC_MODEL": "${YOUR_MODEL_ID}", "ANTHROPIC_SMALL_FAST_MODEL": "${YOUR_MODEL_ID}" }}保存后重新打开终端,使配置生效。
在 CMD 中执行:
setx ANTHROPIC_AUTH_TOKEN "${YOUR_API_KEY}"setx ANTHROPIC_BASE_URL "https://api.do.top/v1"setx ANTHROPIC_MODEL "${YOUR_MODEL_ID}"setx ANTHROPIC_SMALL_FAST_MODEL "${YOUR_MODEL_ID}"重新打开一个 CMD 窗口,检查环境变量是否生效:
echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%
echo %ANTHROPIC_SMALL_FAST_MODEL%在 PowerShell 中执行:
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "${YOUR_API_KEY}", [EnvironmentVariableTarget]::User)[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.do.top/v1", [EnvironmentVariableTarget]::User)[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "${YOUR_MODEL_ID}", [EnvironmentVariableTarget]::User)[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "${YOUR_MODEL_ID}", [EnvironmentVariableTarget]::User)重新打开 PowerShell 窗口,检查环境变量是否生效:
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
echo $env:ANTHROPIC_SMALL_FAST_MODELClaude Code 配置文件通常位于用户目录下:
C:/Users/${YOUR_NAME}/.claude/settings.json参考配置:
{ "env": { "ANTHROPIC_AUTH_TOKEN": "${YOUR_API_KEY}", "ANTHROPIC_BASE_URL": "https://api.do.top/v1", "ANTHROPIC_MODEL": "${YOUR_MODEL_ID}", "ANTHROPIC_SMALL_FAST_MODEL": "${YOUR_MODEL_ID}" }}配置字段说明:
| 字段 | 是否必填 | 说明 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | 是 | 将 ${YOUR_API_KEY} 替换为平台生成的 API Key |
ANTHROPIC_BASE_URL | 是 | 已在示例中填好,无需修改 |
ANTHROPIC_MODEL | 是 | 将 ${YOUR_MODEL_ID} 替换为平台提供的默认模型 ID,例如 GLM-5.2 或 Qwen3.6-27B |
ANTHROPIC_SMALL_FAST_MODEL | 建议填写 | 小模型或快速模型 ID;没有单独小模型时可与默认模型保持一致 |
请替换示例中的两处占位符
${YOUR_API_KEY} 不是固定值,请替换为你在模型服务平台创建的
API Key;${YOUR_MODEL_ID}
也不是模型名称示例,请替换为平台模型列表中真实的模型 ID,例如 GLM-5.2 或
Qwen3.6-27B。复制配置后,可以使用编辑器的“查找并替换”一次性替换所有同名占位符。
Base URL 填写规则
ANTHROPIC_BASE_URL
应填写基础地址,不要填写已经拼接好的完整接口路径。否则客户端可能继续追加接口路径,导致
URL 重复。
2.2 使用cc-switch配置API-KEY
按照如下字段配置即可使用(需开启路由)。
| 字段 | 是否必填 | 内容 | 注意事项 |
|---|---|---|---|
| 供应商名称 | 是 | ${PROVIDER_NAME} | 替换为自定义名称 |
| 官网链接 | 否 | ${PROVIDER_WEBSITE} | 替换为服务平台官网 |
| API Key | 是 | ${YOUR_API_KEY} | 替换为平台创建的API Key |
| 请求地址 | 是 | https://api.do.top/v1 | 不选择完整 URL |
| API 格式 | 是 | OpenAI Chat Completions(需开启路由) | 高级选项 |
| 认证字段 | 是 | ANTHROPIC_AUTH_TOKEN(默认) | 高级选项 |
安装 Claude Code 桌面版
访问 Claude Code 页面下载对应安装包:
https://claude.com/product/claude-code安装完成后打开 Claude Code 桌面版。
配置 Claude Code 桌面版
4.1 使用配置文件配置API-KEY
在顶部菜单栏依次进入:
Help → Troubleshooting → Enable Developer mode勾选开发者模式后,Claude Code 会自动重启。重启后,菜单栏会出现 Developer 菜单。
进入:
Developer → Configure third-party inference会弹出第三方推理配置界面。

填写以下字段:
| 字段 | 示例 | 说明 |
|---|---|---|
| Inference Provider | gateway | 推理提供方式 |
| Gateway base URL | https://api.do.top/v1 | 直接填写此地址,不需要自行替换 |
| Gateway API key | ${YOUR_API_KEY} | 替换为你在模型服务平台创建的 API Key |
添加模型。

模型配置注意事项:
| 字段 | 说明 |
|---|---|
| Model ID | 将 ${CLAUDE_MODEL_ID} 替换为客户端允许识别的 Claude 模型名称,例如 claude-fable-5、claude-haiku-4-5、claude-opus-4-8 等 |
| Display name | 将 ${MODEL_DISPLAY_NAME} 替换为界面展示名称,可填写实际调用模型或便于识别的名称 |
4.2 使用cc-switch配置API-KEY
按照如下字段配置即可使用(需开启路由)。
| 字段 | 是否必填 | 内容 | 注意事项 |
|---|---|---|---|
| 供应商名称 | 是 | ${PROVIDER_NAME} | 替换为自定义名称 |
| 官网链接 | 否 | ${PROVIDER_WEBSITE} | 替换为服务平台官网 |
| API Key | 是 | ${YOUR_API_KEY} | 替换为平台创建的API Key |
| 请求地址 | 是 | https://api.do.top/v1 | 不选择完整 URL |
| API 格式 | 是 | OpenAI Chat Completions(需开启路由) | 高级选项 |
| 认证字段 | 是 | ANTHROPIC_AUTH_TOKEN(默认) | 高级选项 |