Claude Code 对接 DeepSeek V4 完整官方教程(Windows,适配你的C#光模块项目)
前置关键知识点
DeepSeek 原生提供 Anthropic 协议兼容接口,专门适配 Claude Code,不用中转代理,官方对接地址:
- Anthropic 格式BaseURL:
https://api.deepseek.com/anthropic - 可用模型:
deepseek-v4-pro(强推理、读整个大项目首选)deepseek-v4-flash(速度快、性价比高、日常写代码)
- 提前准备:DeepSeek 平台
sk-开头API Key
注意:VS2019 没有Claude Code官方插件 ,Claude Code仅支持 VS Code,下面全程基于VS Code操作
方案一:VS Code Claude Code 插件配置(图形界面,最常用)
步骤1:安装 VS Code + Claude Code 官方插件
- 安装VS Code(和VS2019共存互不冲突)
Ctrl+Shift+X打开扩展市场,搜索 Claude Code(作者Anthropic官方) 安装
步骤2:打开插件设置自定义API端点
- 左下角齿轮 → 设置
- 搜索框输入:
claudeCode.environmentVariables - 点击
Edit in settings.json,全选替换下面配置
json
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.deepseek.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "你的DeepSeek sk-xxxx密钥"
},
{
"name": "ANTHROPIC_MODEL",
"value": "deepseek-v4-pro"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "deepseek-v4-pro"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "deepseek-v4-pro"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "deepseek-v4-flash"
},
{
"name": "CLAUDE_CODE_SUBAGENT_MODEL",
"value": "deepseek-v4-flash"
}
],
"claudeCode.hideOnboarding": true
- 保存文件,完全重启VS Code
步骤3:测试连通性
打开你的QSFP光模块项目文件夹,打开Claude Code侧边栏,发送:
你现在是什么模型?帮我简述当前项目整体结构
能正常回复DeepSeek模型名称=对接成功,可一键读取整个项目目录分析、改代码、重构SCPI通信逻辑
方案二:Claude Code 命令行版全局配置(终端使用)
1. 前置依赖
- 安装 Node.js ≥ 18版本
- 管理员打开PowerShell,全局安装Claude Code
powershell
npm install -g @anthropic-ai/claude-code
2. 临时生效(当前PowerShell窗口)
直接复制执行,替换你的密钥:
powershell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
进入你的项目文件夹,输入 claude 即可启动交互
3. 永久系统环境变量(一劳永逸)
PowerShell管理员执行:
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "Machine")
关闭所有终端重开,任意文件夹直接输入 claude 使用
方案三:项目单独配置(不同项目切换不同密钥/模型)
在你的项目根目录新建文件夹 .claude,新建 settings.json
写入内容:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
"ANTHROPIC_MODEL": "deepseek-v4-pro"
}
}
进入该项目执行 claude,自动读取本项目配置,不影响全局设置
那么密钥在哪里获取呢?
第一步:打开 DeepSeek 平台官网
浏览器访问:https://platform.deepseek.com
- 用国内手机号注册登录
- 完成实名认证(不实名无法调用API扣费使用)
第二步:创建 API Key(就是你要的 sk-xxxx)
- 左侧菜单栏找到 API Keys 选项并点击
- 点击页面蓝色按钮 Create new API Key
- 自定义名称(随便填,比如
VSCode-ClaudeCode),点击创建 - 重点:弹出密钥只会完整显示这一次!立刻复制
格式固定是以sk-开头一长串字符,示例:
sk-987xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
建议粘贴到记事本先临时保存,关掉弹窗就看不到完整密钥了
第三步:替换 VS Code settings.json 里的内容
打开你之前的 Claude Code 配置:
找到这一行
json
"value": "你的DeepSeek sk-xxxx密钥"
把引号中间的文字删掉,粘贴你刚复制的 sk-xxx 完整密钥
改完示例:
json
"ANTHROPIC_AUTH_TOKEN": {
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "sk-987xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
如果是deepseek-v4-pro的话 直接复制下面的这个到setting中
csharp
{"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.deepseek.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "在这里粘贴你完整的DeepSeek sk-xxxx密钥"
},
{
"name": "ANTHROPIC_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "deepseek-v4-pro[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "deepseek-v4-flash[1m]"
},
{
"name": "CLAUDE_CODE_SUBAGENT_MODEL",
"value": "deepseek-v4-flash[1m]"
}
],
"claudeCode.hideOnboarding": true,
// 关键:关闭登录弹窗、强制使用自定义API密钥
"claudeCode.auth.mode": "custom-api",
"claudeCode.skipAuthFlow": true
}
如果是deepseek-v4-flash模型
两种修改方式,任选其一改成 deepseek-v4-flash
方式一:修改 VS Code settings.json 配置(永久全局切换,推荐)
-
打开 VS Code 设置JSON:
左下角齿轮 → 设置 → 搜索
claudeCode.environmentVariables→ 点击「在 settings.json 中编辑」 -
修改两处模型配置:
- 找到
ANTHROPIC_MODEL,把值改成deepseek-v4-flash[1m] - 找到
ANTHROPIC_DEFAULT_OPUS_MODEL,同样改成deepseek-v4-flash[1m]
修改后完整参考配置(直接全量替换也行)
json
{
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.deepseek.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "在这里粘贴你完整的DeepSeek sk-xxxx密钥"
},
{
"name": "ANTHROPIC_MODEL",
"value": "deepseek-v4-flash[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "deepseek-v4-flash[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "deepseek-v4-flash[1m]"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "deepseek-v4-flash[1m]"
},
{
"name": "CLAUDE_CODE_SUBAGENT_MODEL",
"value": "deepseek-v4-flash[1m]"
}
],
"claudeCode.hideOnboarding": true,
"claudeCode.auth.mode": "custom-api",
"claudeCode.skipAuthFlow": true
}
- 保存文件
Ctrl+S,完全关闭重启 VS Code - 新建对话发送:
你现在是什么模型,验证是否切换为 Flash
方式二:单次对话临时切换(不用改配置,临时用)
在当前聊天框第一句直接发系统指令:
接下来所有对话强制使用 deepseek-v4-flash 模型进行回答
仅限当前这个聊天会话有效,新开对话又会变回配置里默认的 Pro。
选型小建议
- 日常写函数、调试小Bug、频繁改代码 :用
deepseek-v4-flash,便宜、响应更快,性价比极高 - 解析整个项目架构、重构大量代码、疑难排错 :切回
deepseek-v4-pro,推理更强、长代码理解更好
需要我顺便给你一句一键切换模型的提示词,以后来回切换更省事吗?
第四步:保存+重启 VS Code
- Ctrl+S 保存 settings.json 文件
- 完全关闭 VS Code,重新打开
- 打开 Claude Code 聊天框发一句:
你是什么模型
能正常回复模型名称 = 密钥配置成功
关键避坑(90%人报错在这里)
- ❌ 密钥前后不能带空格、换行、多余引号,复制时仔细检查首尾
- ❌ 不要把登录账号密码填在这里,只能填平台生成的 sk 密钥
- ❌ 密钥泄露风险:不要发给别人、不要上传到 GitHub 代码仓库
- ✅ 账户需要有余额:新用户一般送小额试用额度,额度用完需要自行充值才能继续调用
额外小提醒
你对接的是 Claude Code(Anthropic 协议),接口地址必须是:
https://api.deepseek.com/anthropic
不要填 OpenAI 格式 /v1 地址,否则一定请求失败。
需要我帮你核对改完后的完整配置是否正确吗?你可以把整段json发出来我帮你检查。