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,全选替换下面配置
"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
npm install-g @anthropic-ai/claude-code2. 临时生效(当前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管理员执行:
[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
写入内容:
{"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 配置:
找到这一行
"value":"你的DeepSeek sk-xxxx密钥"把引号中间的文字删掉,粘贴你刚复制的sk-xxx完整密钥
改完示例:
"ANTHROPIC_AUTH_TOKEN":{"name":"ANTHROPIC_AUTH_TOKEN","value":"sk-987xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},如果是deepseek-v4-pro的话 直接复制下面的这个到setting中
{"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]
修改后完整参考配置(直接全量替换也行)
{"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发出来我帮你检查。