水华 Token 工厂
水华 Token 工厂
首次调用 API
AI 编程工具接入指南
OpenCode 自定义模型接入Claude Code 自定义模型接入Hermes 自定义模型接入Cursor 自定义模型接入VS Code GitHub Copilot 自定义模型接入CC-Switch 自定义模型接入Codex App 自定义模型接入CodeBuddy 自定义模型接入Trae 自定义模型接入常见问题与故障排查
联系我们
AI 编程工具接入指南

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 | bash
powershell 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_MODEL

Claude 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 Providergateway推理提供方式
Gateway base URLhttps://api.do.top/v1直接填写此地址,不需要自行替换
Gateway API key${YOUR_API_KEY}替换为你在模型服务平台创建的 API Key

添加模型。

添加 Claude Code 桌面版模型

模型配置注意事项:

字段说明
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(默认)高级选项

OpenCode 自定义模型接入

查看该工具的安装、自定义模型配置和验证方法。

Hermes 自定义模型接入

查看该工具的安装、自定义模型配置和验证方法。

On this page

使用前准备1安装 Claude Code CLI2配置 Claude Code CLI2.1 使用配置文件配置API-KEY2.2 使用cc-switch配置API-KEY3安装 Claude Code 桌面版4配置 Claude Code 桌面版4.1 使用配置文件配置API-KEY4.2 使用cc-switch配置API-KEY