VSCode Claude Code 接入 DeepSeek 模型完整教程(2026 最新)
Claude Code 是 Anthropic 推出的 AI 编程助手,深度集成 VSCode,默认使用 Anthropic 官方 API(按量计费,价格不菲)。本文将手把手教你如何将 Claude Code 接入 DeepSeek API,利用 DeepSeek 原生支持的 Anthropic Messages API 兼容端点,无需任何中间层或协议转换,替换两个环境变量即可完成。接入后日常编码
·
VSCode Claude Code 接入 DeepSeek
一、前言 / 背景
1.1 什么是 Claude Code?
Claude Code 是 Anthropic 官方推出的 CLI 编程助手,深度集成 VSCode 。支持终端模式、IDE 扩展模式,可以读写文件、执行命令、管理 Git 等。
1.2 为什么要接入 DeepSeek?
- 成本极低:DeepSeek API 价格远低于 Anthropic 官方 API(详见第 7 章价格对比)
- 编程能力强劲:DeepSeek V4 在日常编码任务上表现接近 Claude Opus 4
- 低延迟:国内用户访问 DeepSeek API 延迟更低,无需科学上网
1.3 原理简述
- Claude Code 通过环境变量
ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL来指定 API 地址和密钥 - DeepSeek 提供了原生的 Anthropic Messages API 兼容端点(
/anthropic),无需额外协议转换 - 只需将
ANTHROPIC_BASE_URL指向 DeepSeek 的 Anthropic 兼容端点即可接入
二、环境准备
2.1 前置条件
| 条件 | 说明 |
|---|---|
| VSCode | 最新版本即可 |
| Claude Code CLI | 需先安装 |
| DeepSeek API Key | 在 platform.deepseek.com 申请 |
| Node.js | >= 18.x |
2.2 安装 Claude Code
VSCode 扩展安装
在 VSCode 扩展市场搜索 Claude Code 或 Anthropic,安装官方扩展。
三、核心配置步骤(重点章节)
3.1 配置方式概览
Claude Code 读取 API 配置的优先级如下:
| 优先级 | 配置方式 | 说明 |
|---|---|---|
| 高 | VSCode settings.json 中的环境变量 |
影响 VSCode 集成终端,推荐 VSCode 用户使用 |
| 中 | ~/.bashrc / ~/.zshrc 环境变量 |
Git Bash / WSL 终端适用 |
| 低 | Windows 系统环境变量 | 所有程序通用 |
3.2 推荐方式:VSCode User Settings JSON(实测可用)
这是我实际使用并验证成功的方式。
步骤:
- 在 VSCode 中按
Ctrl + Shift + P,输入Preferences: Open User Settings (JSON),回车 - 在打开的
settings.json中添加terminal.integrated.env.windows配置:
{
// ... 你已有的其他配置 ...
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.deepseek.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "sk-xxxxxxxxxxxxxxx"
},
{
"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"
},
{
"name": "CLAUDE_CODE_SUBAGENT_MODEL",
"value": "deepseek-v4-flash"
},
{
"name": "CLAUDE_CODE_EFFORT_LEVEL",
"value": "max"
}
],
"claudeCode.preferredLocation": "panel"
}
重点 需要加入[1m]后缀启动超大上下文

- 保存文件,重启 VSCode 使环境变量生效
四、验证配置是否生效
4.1 终端验证
# 查看当前使用的模型
claude --model
# 启动一次简单对话测试
echo "用 Python 写一个 hello world" | claude -p
4.2 VSCode 内验证
- 打开 VSCode,
Ctrl+Shift+P打开命令面板 - 输入
Claude Code: Start New Chat或直接按快捷键 - 输入一个简单问题如:“用 Python 写一个 hello world”
- 观察返回结果,确认模型能正常响应
五、常见问题 & 排错
| 问题 | 原因 | 解决 |
|---|---|---|
401 Unauthorized |
API Key 无效或过期 | 检查 DeepSeek 后台余额和 Key 状态 |
404 Not Found |
baseUrl 路径错误 | 确保拼接后为 https://api.deepseek.com/anthropic,不要多写也不要漏写 |
| 环境变量修改后不生效 | VSCode 缓存了旧环境变量 | 重启 VSCode(不是重新加载窗口,是完全退出再打开) |
| Claude Code 仍然连接 Anthropic 官方 | 环境变量被其他配置覆盖 | 终端中执行 echo $ANTHROPIC_BASE_URL 确认值是否正确 |
| WSL 环境下环境变量不生效 | VSCode 的 terminal.integrated.env.windows 不影响 WSL 终端 |
需在 WSL 内的 ~/.bashrc 单独设置 |
| 响应速度慢 | 网络延迟 | DeepSeek API 国内访问较快,如仍慢可检查是否走了代理 |
六、效果对比 & 使用体验
6.1 价格对比(以 1M tokens 为单位)
| Anthropic 官方(Claude Opus 4) | DeepSeek V4 | |
|---|---|---|
| 输入价格 | ~$15 | ~$0.27 |
| 输出价格 | ~$75 | ~$1.10 |
| 总成本(假设 1:1 输入输出比) | ~$90 | ~$1.37 |
成本差距约 65 倍。数据以各自官网最新价格为准。
七、总结
- 核心就两步:在 VSCode User Settings JSON 中配置
ANTHROPIC_BASE_URL指向 DeepSeek,加上 API Key,同时设置默认调用模型,重启 VSCode 即完成 - DeepSeek 提供了原生的
/anthropic端点,兼容 Anthropic Messages API,无需额外协议转换 - 成本从 ~$90/M tokens 降到 ~$1.37/M tokens,约 65 倍差距
- 日常开发完全够用,对预算有限或国内用户非常友好
更多推荐




所有评论(0)