Claude Code
下载
聚焦模式
字号
Claude Code 是一款运行在终端中的 AI 编程工具，可以通过灵活的自然语言辅助开发者高效编码、调试和管理代码。本文以 DeepSeek V4 Pro 模型为例演示如何将模型接入到 Claude Code 中使用。
安装 Claude Code
获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：
在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 DeepSeek V4 Pro。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
配置 Claude Code
1. 手动配置模型的环境变量
完成 Claude Code 安装和 API Key 的获取后，需要配置 DeepSeek V4 Pro 模型的 API 信息，具体配置方式如下：
编辑或新增
settings.json 文件，并根据您获取 API Key 的渠道，增加对应的配置文件内容，不同系统的配置文件路径不同，具体可参考：MacOS/Linux 对应路径为
~/.claude/settings.jsonWindows 对应路径为
用户目录/.claude/settings.json若
settings.json 文件不存在，可使用文本编辑器（如 VSCode、记事本等）手动创建，或在终端中执行以下命令创建：# MacOS/Linuxmkdir -p ~/.claude && touch ~/.claude/settings.json# Windows（PowerShell）New-Item -ItemType Directory -Force -Path "$HOME\\.claude" | Out-Null; New-Item -ItemType File -Force -Path "$HOME\\.claude\\settings.json" | Out-Null
配置以下内容（注意将
YOUR_API_KEY 替换为真实 API Key）：{"env": {"ANTHROPIC_BASE_URL": "https://tokenhub-intl.tencentcloudmaas.com","ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY","ANTHROPIC_MODEL": "deepseek-v4-pro","ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro","ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro","ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro","CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro","ENABLE_TOOL_SEARCH": false}}
各环境变量含义如下：
环境变量 | 是否必填 | 说明 |
ANTHROPIC_BASE_URL | 是 | Claude Code 请求的 API 网关地址。接入 TokenHub 时固定为 https://tokenhub-intl.tencentcloudmaas.com。 |
ANTHROPIC_AUTH_TOKEN | 是 | 用于鉴权的 API Key，需替换为您在 TokenHub 控制台创建的真实 API Key。请妥善保管，避免泄露。 |
ANTHROPIC_MODEL | 是 | Claude Code 默认调用的模型名。本文以 deepseek-v4-pro 为例，您也可以替换为 TokenHub 支持的其他模型。 |
ANTHROPIC_DEFAULT_OPUS_MODEL | 否 | Claude Code 中 Opus 档位（高复杂度任务）映射到的模型。这里设为 deepseek-v4-pro，使所有档位统一指向同一个模型。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 否 | Claude Code 中 Sonnet 档位（默认日常任务）映射到的模型。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 否 | Claude Code 中 Haiku 档位（轻量/快速任务）映射到的模型。 |
CLAUDE_CODE_SUBAGENT_MODEL | 否 | Claude Code 创建子任务（subagent）时使用的模型。建议与主模型保持一致，避免出现跨模型调用导致的兼容性问题。 |
ENABLE_TOOL_SEARCH | 否 | 是否启用 Claude Code 内置的原生 web search 工具。由于 Claude Code 禁止第三方模型使用内置搜索，这里需设为 false。 |
保存配置后，请打开新的终端窗口执行后续命令，确保环境变量加载生效。
2. 确认环境变量是否生效
进入命令行界面，执行以下命令启动 Claude Code：
# 打开项目目录cd your-project# 启动 Claude Codeclaude
注意：
若您是首次启动 Claude Code，终端会先进入交互式初始化向导，依次提示您选择主题（Theme）、登录方式（Login Method）等。请按照终端提示完成首次配置后再继续后续步骤。
启动成功后，在 Claude Code 中输入
/status 确认模型状态生效（参考下图示例）：当 API Endpoint 显示为 https://tokenhub-intl.tencentcloudmaas.com，且 Model 显示为 deepseek-v4-pro 时，即表示模型配置已生效。
文档反馈