Claude Code接入DeepSeek并在VSCode中配置实操

Claude Code是一个命令行形态的AI编程工具。它负责读取项目、调度任务，真正理解代码并生成修改的是背后的大模型。默认情况下，它连接的是Anthropic的模型。DeepSeek提供了兼容Anthropic消息格式的接口，因此可以把Claude Code的请求指向DeepSeek。这样既保留了Claude Code的操作方式，又能使用DeepSeek的模型。

需要先说明一点：本文不预设某个具体的模型版本号。模型名称和接口地址会随官方更新而变化。文中的值以撰写时DeepSeek文档的写法为例，实际操作前请到官方文档核对当前的地址与模型ID。

一、先确定模型与成本预期

Claude Code会在一次会话中调用主模型和较轻量的辅助模型。编程任务需要较强的代码理解能力，长文件重构还需要较大的上下文窗口。日常问答和简单解释则可以选择更轻量的模型。

选型时可以按下表逐项核对：

维度	看什么	去哪里核对
编程能力	是否为面向代码优化的版本，或官方公布的代码评测成绩	官方模型介绍页
上下文长度	单次请求能容纳的最大Token数	官方模型参数表
价格	输入、输出和缓存命中的单价	官方定价页

大模型按Token计费，输入和输出的单价通常不同。Claude Code每次请求都会带上大量代码上下文，所以一次会话的实际消耗往往远高于单条提问。估算费用时可以使用下面的公式：

单次会话费用 ≈ 输入Token数 × 输入单价 + 输出Token数 × 输出单价

假设一次会话累计输入30万Token、输出2万Token，输入单价为a元每百万Token，输出单价为b元每百万Token，那么费用约为0.3 × a + 0.02 × b元。单价口径请以官方定价页为准，部分平台按每千Token或缓存命中情况分别计价。

二、获取DeepSeek API Key

1. 打开DeepSeek开放平台（https://platform.deepseek.com/）并登录。
2. 进入API Key管理页面，点击创建新的Key。
3. 立即复制并保存这个Key。大多数平台只在创建时完整显示一次，关闭弹窗后只能重新生成。

建议把Key保存到系统的密码管理器中。不要把它写进项目代码，也不要提交到Git仓库。为不同项目分别创建Key，便于按项目统计用量。某个Key泄露时，只需吊销它，其他项目不受影响。

三、安装CC Switch

Claude Code依赖环境变量或配置文件来指定模型服务。手动修改这些配置容易出错，切换供应商时还要反复编辑。CC Switch是一个跨平台的配置管理工具，可以保存多套供应商配置，并在它们之间切换。

安装步骤如下：

• 项目地址：https://github.com/farion1231/cc-switch
• 打开项目的Releases页面，下载与你的系统匹配的安装包。Windows用户选择.msi，macOS用户选择.dmg，Linux用户可以选择AppImage或与发行版对应的安装包。
• 下载后，核对发布页提供的SHA256校验值，确认文件完整。

安装并打开CC Switch后，检查预设供应商列表中是否已有DeepSeek条目。如果有，直接选用并补全Key即可。如果没有，就手动新增一个自定义供应商。

四、填写配置参数

在CC Switch中点击“添加”，新建一个供应商。需要填写的字段如下：

配置项	填写内容	说明
供应商名称	DeepSeek	自定义，便于识别
接口地址（Base URL）	https://api.deepseek.com/anthropic	DeepSeek文档中的Anthropic兼容地址，以官方当前写法为准
API Key	第二步保存的Key	粘贴后检查首尾是否有多余空格或换行
模型名称	官方模型列表中的模型ID，例如deepseek-chat	模型ID以官方文档为准，旧教程中的名称可能已失效

如果CC Switch的表单中有“环境变量”或“高级”选项，可以对应填写以下变量。Claude Code通过这些变量决定请求发往哪里、使用哪个模型。

macOS或Linux终端中：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"
export ANTHROPIC_MODEL="deepseek-chat"

Windows PowerShell中：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"
$env:ANTHROPIC_MODEL="deepseek-chat"

上面的变量只对当前终端窗口有效。关闭窗口后失效。使用CC Switch时，切换供应商会自动写入Claude Code的配置，不需要手动设置环境变量。两种方式只保留一种即可。同时存在时以哪个为准，取决于Claude Code版本，所以第五步的验证不可省略。

如果你使用的是第三方中转服务，而不是DeepSeek官方接口，请注意两点。第一，这类服务不是官方渠道，返回结果的一致性和稳定性需要自行评估。第二，Key会交给第三方平台，存在泄露和数据留存的风险。使用前应确认服务方的隐私政策，并为它单独创建Key。

填写完成后保存，并在CC Switch中把当前激活的配置切换为DeepSeek。

五、在VSCode中验证接入

验证前需要满足两个前提。第一，本机已安装Node.js，版本以Claude Code官方安装文档的要求为准。第二，Claude Code本体已安装。可以在终端执行以下命令安装：

npm install -g @anthropic-ai/claude-code
claude --version

能输出版本号即表示安装成功。若提示找不到命令，检查npm全局安装目录是否已加入系统PATH。

接下来按以下步骤操作：

1. 用VSCode打开项目文件夹，按Ctrl+``（macOS为Cmd+``）打开集成终端。
2. 在项目根目录执行claude，启动Claude Code。
3. 进入交互界面后，输入/status或/model查看当前使用的模型和配置。不同版本的命令名称可能不同，