适合人群:想在 VS Code 里用 Claude Code 体验,但希望把后端模型换成 DeepSeek,并且不想先折腾 CCSwitch 或 CLI 的用户。

在这里插入图片描述

先说结论

这篇教程推荐的架构是:

VS Code
  -> Claude Code 插件
  -> VS Code settings.json 里的 claudeCode.environmentVariables
  -> DeepSeek Anthropic API
  -> deepseek-v4-flash / deepseek-v4-pro[1m]

不推荐小白一开始用 CLI,也不推荐一开始上 CCSwitch。原因很简单:我们只需要把 Claude Code 的 API 入口指向 DeepSeek 的 Anthropic 兼容接口,VS Code 插件已经能提供图形界面、Diff 审阅、文件上下文和权限确认。CLI 和 CCSwitch 都能玩,但它们更适合已经熟悉终端、环境变量和多模型路由的人。

模型选择上,性价比优先用 deepseek-v4-flash。日常解释代码、改小 bug、生成函数、写脚本,先让 flash 扛。遇到长上下文、复杂架构分析、多文件重构,再切到 deepseek-v4-pro[1m]

整体流程

在这里插入图片描述

第 1 步:安装 Claude Code 插件

在这里插入图片描述

打开 VS Code,进入扩展面板:

  • Windows / Linux:Ctrl + Shift + X
  • macOS:Cmd + Shift + X

搜索 Claude Code,点击安装。

这里强烈建议小白优先使用 VS Code 插件版。官方文档也把 VS Code 插件描述为在 VS Code 中使用 Claude Code 的推荐方式,插件提供图形界面、计划审阅、Diff 修改确认、文件引用和会话管理。插件本身也包含 CLI 能力,但一开始没有必要先从命令行入门。

注意:VS Code 版本需要满足插件要求。官方文档当前写的是 VS Code 1.98.0 或更高版本。如果装不上,先升级 VS Code。

第 2 步:打开 VS Code 的 Settings JSON

在 VS Code 里打开命令面板:

  • Windows / Linux:Ctrl + Shift + P
  • macOS:Cmd + Shift + P

搜索并打开:

Preferences: Open User Settings (JSON)

也可以打开设置页,在搜索框里搜 Claude Code,找到插件配置项。为了复制配置更清晰,本教程建议直接改 settings.json

第 3 步:写入最基础配置

在这里插入图片描述

把下面这段放进 VS Code 的用户级 settings.json。如果你原本已经有很多设置,不要整段覆盖,只把这些字段合并进去。

完整模板文件也已经放在本目录:

claude-code-deepseek-settings-basic.jsonc
{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.initialPermissionMode": "default",
  "claudeCode.allowDangerouslySkipPermissions": false,
  "claudeCode.selectedModel": "deepseek-v4-flash",

  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.deepseek.com/anthropic"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-****"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "deepseek-v4-flash"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "deepseek-v4-flash"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_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"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "CLAUDE_CODE_ATTRIBUTION_HEADER",
      "value": "0"
    }
  ]
}

sk-**** 换成你自己的 DeepSeek API Key。写文章、截图、发群、发视频时,只能展示 sk-****,不要展示完整 Key。

每一行是什么意思

配置项 作用 小白建议
claudeCode.preferredLocation 控制 Claude Code 打开位置。panel 表示在 VS Code 面板里使用。 保持 panel
claudeCode.disableLoginPrompt 使用第三方 API 时,尽量跳过 Claude 官方登录提示。 如果插件版本不识别这个字段,删除即可。
claudeCode.initialPermissionMode 新会话的权限模式。default 会在关键操作前确认。 新手用 default,熟悉后再考虑 acceptEdits
claudeCode.allowDangerouslySkipPermissions 是否允许绕过权限。 公开教程不建议开,默认 false
claudeCode.selectedModel 插件优先选择的模型。 先用 deepseek-v4-flash 控成本。
ANTHROPIC_BASE_URL 把 Claude Code 的请求指向 DeepSeek 的 Anthropic 兼容接口。 固定写 https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN DeepSeek API Key。 只放本地,截图必须打码。
ANTHROPIC_MODEL Claude Code 默认主模型。 性价比优先写 deepseek-v4-flash
ANTHROPIC_DEFAULT_SONNET_MODEL 当 Claude Code 请求 Sonnet 类模型时映射到哪个 DeepSeek 模型。 日常写 deepseek-v4-flash
ANTHROPIC_DEFAULT_OPUS_MODEL 当 Claude Code 请求 Opus 类模型时映射到哪个 DeepSeek 模型。 复杂任务可写 deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODEL 当 Claude Code 请求 Haiku 类模型时映射到哪个 DeepSeek 模型。 轻量任务写 deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL 子任务、子代理使用的模型。 deepseek-v4-flash 省钱。
CLAUDE_CODE_EFFORT_LEVEL 推理努力程度。 想要更稳可以用 max
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 尽量减少非必要流量。 保持 1
CLAUDE_CODE_ATTRIBUTION_HEADER 控制归因相关 header。 保持 0

为什么这个版本比 CCSwitch 更适合小白

在这里插入图片描述

CCSwitch 的价值是“多供应商、多模型、多配置切换”。如果你每天要在 Anthropic、DeepSeek、OpenRouter、硅基流动、本地模型之间来回切,它很有用。

但这篇教程的目标不是搭一个复杂网关,而是让 VS Code 里的 Claude Code 直接跑起来。所以最小可用架构就是:

Claude Code 插件 -> DeepSeek Anthropic API

少一层转发,就少一层排错。新手最容易卡在环境变量、代理、路径、Shell 启动方式、CLI 权限上。插件版的好处是所有入口都在 VS Code 里,出问题也更容易定位。

成本怎么选

DeepSeek 官方价格页当前列出了 deepseek-v4-flashdeepseek-v4-pro,并提供 Anthropic 格式的 Base URL。按 2026-06-10 查询到的价格,deepseek-v4-flash 的输入和输出单价都明显低于 deepseek-v4-pro。所以我的建议是:

  • 日常写代码、解释代码、生成小工具:deepseek-v4-flash
  • 大型项目理解、复杂重构、长上下文分析:deepseek-v4-pro[1m]
  • 子任务、子代理、自动检查:deepseek-v4-flash

也就是说,默认省钱,必要时再上强模型。

第 4 步:重载 VS Code 并验证

保存 settings.json 后,执行一次:

Developer: Reload Window

或者直接重启 VS Code。

然后打开一个项目,点右上角或侧边栏的 Claude Code / Spark 图标,试一个简单问题:

请解释当前文件的主要逻辑,并指出有没有明显可以优化的地方。

如果能正常回复,说明插件到 DeepSeek 的链路已经打通。再试一个需要修改文件的任务:

帮我给这个函数补充错误处理,但先给我看修改计划,不要直接大改。

新手建议先保持权限模式为 default,看清楚 Diff 再接受。

常见问题

1. 插件还是让我登录 Claude 怎么办?

先确认 claudeCode.disableLoginPrompt 是否生效。如果插件版本不支持这个字段,尝试在 Claude Code 设置里搜索 login,把登录提示关闭。然后重载窗口。

2. 一直没有响应怎么办?

检查四件事:

  • ANTHROPIC_AUTH_TOKEN 有没有填错。
  • ANTHROPIC_BASE_URL 是否是 https://api.deepseek.com/anthropic
  • 公司或本机代理是否影响 VS Code 访问外网。
  • 当前 VS Code 是否读取到了最新 settings,必要时重启 VS Code。

3. 要不要把整份 VS Code settings 发出来?

不要。公开教程只贴 Claude Code 相关配置。以下内容都不要出现在截图或文章里:

  • 完整 API Key
  • 任何 token
  • 代理地址和端口
  • 内网 IP
  • SSH 主机配置
  • 本机用户名路径
  • 公司项目路径

如果你要截图,推荐先复制一份干净的 settings,只保留本教程里的字段,并把 Key 改成 sk-****

4. 能不能直接用 acceptEdits

可以,但不建议小白第一天就开。acceptEdits 的体验更顺滑,但它会减少你逐次确认修改的机会。等你熟悉 Claude Code 的 Diff、权限和撤回方式后,再把:

"claudeCode.initialPermissionMode": "acceptEdits"

打开也不迟。

参考资料

  • Anthropic Claude Code VS Code 官方文档:https://code.claude.com/docs/en/ide-integrations
  • DeepSeek Claude Code 接入文档:https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code
  • DeepSeek 模型与价格:https://api-docs.deepseek.com/quick_start/pricing
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐