前言Claude Code 是 Anthropic 推出的 AI 编程工具可以读取当前项目、分析代码、修改文件并辅助完成开发任务。默认情况下Claude Code 使用 Anthropic 官方服务。由于 DeepSeek 提供了兼容 Anthropic API 格式的接口因此可以通过配置 API 地址、API Key 和模型名称让 VS Code 中的 Claude Code 插件调用 DeepSeek 模型。本文介绍以下内容安装 VS Code Claude Code 插件配置 DeepSeek API设置默认模型验证配置是否生效一、准备工作开始配置前需要准备已安装 VS Code已打开需要使用 Claude Code 的项目已获取可用的 DeepSeek API Key需要使用的 DeepSeek Anthropic 兼容接口为https://api.deepseek.com/anthropic本文使用以下占位符表示 API KeyYOUR_DEEPSEEK_API_KEY实际配置时需要替换为自己的真实 DeepSeek API Key。不要把真实 API Key 上传到 GitHub、博客、截图或公开聊天中。密钥一旦泄露应立即在平台后台将其作废并重新创建。二、安装 Claude Code 插件在 VS Code 中按Ctrl Shift X打开扩展面板搜索Claude Code安装 Anthropic 发布的 Claude Code 扩展。安装完成后可以按Ctrl Shift P执行Developer: Reload Window重新加载 VS Code 窗口。Remote-SSH 环境下的注意事项如果当前项目通过 Remote-SSH 打开需要在扩展面板中确认 Claude Code 是否安装在当前远程环境中。三、推荐的配置方式Claude Code 插件可以通过两种方式读取 DeepSeek API 配置方式一Claude Code 用户配置文件将配置写入~/.claude/settings.json这种方式的优点是配置由 Claude Code 自身管理不依赖 VS Code 的插件环境变量设置本地项目和远程项目可以分别配置配置结构更清晰可以避免 VS Code 多套设置互相覆盖。方式二VS Codesettings.json将环境变量直接写入claudeCode.environmentVariables:[]这种方式配置直观但在本地 VS Code、Remote-SSH 用户设置和远程设置同时存在时容易出现配置来源不明确的问题。建议两种方式选择一种不要同时维护两套相同配置。四、使用~/.claude/settings.json配置 DeepSeek1. 创建配置目录在 VS Code 集成终端中执行mkdir-p~/.claude2. 创建配置文件执行nano~/.claude/settings.json写入{$schema:https://json.schemastore.org/claude-code-settings.json,env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:YOUR_DEEPSEEK_API_KEY,ANTHROPIC_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-v4-flash,CLAUDE_CODE_EFFORT_LEVEL:max,CLAUDE_CODE_MAX_OUTPUT_TOKENS:32000}}将YOUR_DEEPSEEK_API_KEY替换为自己的 DeepSeek API Key。3. 保存文件在 nano 中按Ctrl O按 Enter 保存然后按Ctrl X退出编辑器。4. 限制配置文件权限由于配置文件中包含 API Key建议执行chmod700~/.claudechmod600~/.claude/settings.json检查权限ls-ld~/.claudels-l~/.claude/settings.json配置文件权限通常应显示为-rw-------表示只有当前用户能够读取和修改该文件。五、配置项说明1.ANTHROPIC_BASE_URLANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic用于指定 Claude Code 请求的 API 地址。配置后Claude Code 不再请求默认的 Anthropic 官方接口而是请求 DeepSeek 提供的 Anthropic 兼容接口。整体调用关系为VS Code Claude Code 插件 ↓ DeepSeek Anthropic 兼容接口 ↓ DeepSeek 模型2.ANTHROPIC_AUTH_TOKENANTHROPIC_AUTH_TOKEN:YOUR_DEEPSEEK_API_KEY用于 API 身份认证。虽然变量名称中包含ANTHROPIC但这里填写的是 DeepSeek API Key。3.ANTHROPIC_MODELANTHROPIC_MODEL:deepseek-v4-pro[1m]设置 Claude Code 默认使用的主模型。deepseek-v4-pro[1m]表示使用 DeepSeek V4 Pro 对应的长上下文模型配置。模型名称需要严格按照 DeepSeek 当前提供的 Claude Code 接入格式填写。4. Opus 模型映射ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-pro[1m]当 Claude Code 内部需要调用 Opus 档位模型时将实际模型映射到deepseek-v4-pro[1m]5. Sonnet 模型映射ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-pro[1m]当 Claude Code 内部需要调用 Sonnet 档位模型时同样使用deepseek-v4-pro[1m]6. Haiku 模型映射ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash当 Claude Code 需要执行速度优先、开销较低的任务时可以使用deepseek-v4-flash7. 子代理模型CLAUDE_CODE_SUBAGENT_MODEL:deepseek-v4-flashClaude Code 在执行复杂任务时可能会创建子代理处理代码搜索、信息提取、并行分析等子任务。这里将子代理设置为较快的 Flash 模型可以减少响应时间和调用成本。8. 推理强度CLAUDE_CODE_EFFORT_LEVEL:max用于设置模型的推理强度。较高的推理强度通常适合复杂代码分析多文件修改Bug 定位架构设计大规模代码重构但也可能增加响应时间和 Token 消耗。普通使用时也可以根据需要调整为较低级别。9. 最大输出长度CLAUDE_CODE_MAX_OUTPUT_TOKENS:32000表示期望单次响应最多输出 32000 tokens。需要注意这只是客户端配置值实际输出长度仍然可能受到以下因素限制模型最大输出长度API 服务限制当前上下文剩余空间Claude Code 内部限制服务商账户额度因此将该值设置为32000不代表每次响应都会输出 32000 tokens。六、配置 VS Code 插件选项在 VS Code 中按Ctrl Shift P执行Preferences: Open User Settings (JSON)加入{claudeCode.preferredLocation:panel,claudeCode.disableLoginPrompt:true}如果文件中已经存在其他配置只需要把这两个字段合并进去。例如{editor.fontSize:18,explorer.confirmDelete:false,claudeCode.preferredLocation:panel,claudeCode.disableLoginPrompt:true}七、claudeCode.preferredLocation的作用claudeCode.preferredLocation:panel用于设置 Claude Code 默认显示位置。设置为panel后Claude Code 通常显示在 VS Code 底部面板区域。如果希望显示在侧边栏可以尝试claudeCode.preferredLocation:sidebar八、claudeCode.disableLoginPrompt的作用claudeCode.disableLoginPrompt:true表示关闭 Anthropic 官方账号登录提示。使用 DeepSeek Anthropic 兼容接口时Claude Code 通过以下配置完成认证ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN因此不需要再登录 Anthropic 官方账号。九、是否需要配置claudeCode.environmentVariables如果不想使用~/.claude/settings.json也可以直接在 VS Code 中配置环境变量。打开 VS Code 的settings.json写入{claudeCode.preferredLocation:panel,claudeCode.disableLoginPrompt:true,claudeCode.environmentVariables:[{name:ANTHROPIC_AUTH_TOKEN,value:YOUR_DEEPSEEK_API_KEY},{name:ANTHROPIC_BASE_URL,value:https://api.deepseek.com/anthropic},{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},{name:CLAUDE_CODE_SUBAGENT_MODEL,value:deepseek-v4-flash},{name:CLAUDE_CODE_EFFORT_LEVEL,value:max},{name:CLAUDE_CODE_MAX_OUTPUT_TOKENS,value:32000}]}这种方式的优点是所有配置都集中在 VS Code 中。缺点是API Key 会直接保存在 VS Code 配置文件中VS Code 设置同步可能同步密钥本地设置和远程设置可能发生混淆多个 VS Code 窗口可能读取不同范围的设置排查配置来源时更复杂。因此更推荐将 API 配置保存在~/.claude/settings.json而 VS Code 中只保留{claudeCode.preferredLocation:panel,claudeCode.disableLoginPrompt:true}十、重新加载插件配置修改配置后按Ctrl Shift P执行Developer: Reload Window重新加载 VS Code 窗口。如果使用 Remote-SSH并且修改后插件仍然没有读取新配置可以执行Remote-SSH: Kill VS Code Server on Host然后重新连接远程环境。需要注意执行该命令会结束当前远程 VS Code Server会断开当前远程窗口。