Claude Code × DeepSeek V4：从零开始配置与调用实战
目录
- 准备工作
- 第一阶段：获取 DeepSeek API Key
- 1.1 注册/登录 DeepSeek
- 1.2 创建 API Key
- 第二阶段：配置 Claude Code 连接 DeepSeek
- 2.1 找到配置文件
- 2.2 写入最小可用配置
- 2.3 可选：添加进阶配置（可先跳过）
- 模型映射策略说明
- 关于 1M 上下文
- 关于 CLAUDE_CODE_EFFORT_LEVEL（推理档位）
- 第三阶段：启动并验证连接
- 3.1 首次启动 Claude Code
- 3.2 选择界面样式
- 3.3 信任工作目录
- 3.4 首次提问验证
- 第四阶段：切换模型（按需使用）
- 4.1 了解 DeepSeek V4 模型
- 4.2 切换模型的方法
- 第五阶段：探索更多功能
- 5.1 查询可用技能
- 故障排查
- 问题1：启动时提示 "Unable to connect to Anthropic services"
- 问题2：遇到 401 未授权错误
- 常见问题解答
- Q1: 除了 DeepSeek，还能配置其他模型吗？
- Q2: 如何确保 API Key 的安全？
本文基于 在 Claude Code中配置DeepSeek：从报错到成功调用【支持DeepSeekV4】 之上进行完全重构，原文是以问题为导向创作，不太适合实操。于是改为以新手视角为导向，完整介绍从零开始配置Claude Code + DeepSeek V4
准备工作
在开始之前，请确保你已经具备以下条件：
- 已安装 Claude Code（可直接让Trae、Cursor、CodeBuddy这类AI工具帮你下载和配置环境）
- 知道如何在命令行中输入命令
- Windows Claude命令行工具一般在
C:\Users\你的用户名\.local\bin目录下，如果遇到Claude命令无法识别，知道如何配置环境变量
第一阶段：获取 DeepSeek API Key
获取 API Key 是所有流程中最重要的，不然 Claude Code 会反复报 401 错误。
1.1 注册/登录 DeepSeek
访问 DeepSeek 官方网站 https://www.deepseek.com/，选择进入 API 开放平台。
1.2 创建 API Key
选择页面【API keys】：
进入 API 管理页面，创建一个新的 API Key：
⚠️ 重要提示：创建 API Key 后，请立即复制并妥善保存，因为页面关闭后将无法再次查看完整的 Key。建议先粘贴到一个临时文本文件中，下一步会用到。
第二阶段：配置 Claude Code 连接 DeepSeek
2.1 找到配置文件
Claude Code 的配置文件位于用户目录下的.claude文件夹中：
在 Windows 系统中，路径为：C:\Users\你的用户名\.claude\
在该文件夹下找到或新建settings.json文件。
2.2 写入最小可用配置
打开settings.json，写入以下配置。这是最简配置，保证你能先跑起来：
{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","ANTHROPIC_MODEL":"deepseek-v4-flash"}}操作说明：
- 将
"sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"替换为你刚才从 DeepSeek 官网复制的真实 API Key - 注意保留两边的双引号
" ANTHROPIC_MODEL默认使用deepseek-v4-flash（高速响应模型，适合日常对话）
为什么配置项叫 ANTHROPIC_XXX？
因为 Claude Code 是为 Anthropic 官方服务设计的，DeepSeek 提供了兼容 Anthropic API 格式的接口，所以配置项名称保持不变，只需把地址指向 DeepSeek 即可。
2.3 可选：添加进阶配置（可先跳过）
如果你希望 Claude Code 更少打扰、更自动化，可以追加以下配置：
{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"你的DeepSeek API KEY","ANTHROPIC_MODEL":"deepseek-v4-flash","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-flash","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro[1m]","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-flash","API_TIMEOUT_MS":"600000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1","CLAUDE_CODE_EFFORT_LEVEL":"medium"},"skipDangerousModePermissionPrompt":true,"bypassPermissions":true}参数说明：
| 配置项 | 作用 |
|---|---|
| ANTHROPIC_MODEL | 默认模型，claude 命令启动时直接使用 |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | 轻量级任务模型（快速响应、低成本） |
| ANTHROPIC_DEFAULT_SONNET_MODEL | 中等复杂度任务模型（平衡性能与速度） |
| ANTHROPIC_DEFAULT_OPUS_MODEL | 复杂任务/代码生成模型（最强性能） |
| CLAUDE_CODE_SUBAGENT_MODEL | 子代理/后台任务模型（自动执行时调用） |
| CLAUDE_CODE_EFFORT_LEVEL | 推理档位，控制模型思考深度（见下方详解） |
| API_TIMEOUT_MS | 请求超时时间，单位毫秒。600000 = 10分钟 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 关闭非必要网络请求，减少报错 |
| skipDangerousModePermissionPrompt | 跳过危险操作确认提示 |
| bypassPermissions | 自动授权文件读写等权限 |
💡新手建议：第一次配置先用最简版本，等能正常对话了，再回来加这些进阶配置。
模型映射策略说明
Claude Code 内置了 Anthropic 的三档模型体系（Haiku / Sonnet / Opus），上述配置项用于把 DeepSeek 模型映射到对应档位：
推荐配置策略：
| 任务类型 | 推荐模型 | 理由 |
|---|---|---|
| 日常交互、快速问答 | deepseek-v4-flash | 响应快、成本低 |
| 代码生成、大文件分析 | deepseek-v4-pro[1m] | 能力强、支持长上下文 |
| 后台自动执行、子任务 | deepseek-v4-flash | 不阻塞、效率高 |
关于 1M 上下文
deepseek-v4-pro[1m]中的[1m]是DeepSeek 的上下文窗口标识：
| 后缀 | 含义 | 上下文长度 |
|---|---|---|
| 无后缀 / [128k] | 标准版 | 128K tokens |
| [1m] | 长上下文版 | 1M tokens（100万） |
⚠️注意：1M 上下文模型通常价格更高、响应更慢。
关于 CLAUDE_CODE_EFFORT_LEVEL（推理档位）
CLAUDE_CODE_EFFORT_LEVEL用于控制模型的思考深度——即每次响应时分配的"推理预算"（考虑多少方案、验证多少边界情况）。
支持的档位：
| 档位 | 说明 | 适用场景 |
|---|---|---|
| low | 最小推理预算，响应最快 | 简单重命名、格式化、单行修改 |
| medium | 中等预算，均衡成本与质量 | 日常开发任务、写函数、改 bug |
| high | 大预算，追踪复杂逻辑 | 复杂重构、多文件改动、难以定位的 bug |
| xhigh | 超高预算（Opus 4.7 独有） | 长时间 agent 任务、复杂架构设计 |
| max | 无上限，全力推理 | 最复杂的任务，慎用（可能过度思考） |
配置示例：
{"env":{"CLAUDE_CODE_EFFORT_LEVEL":"high"}}可在Claude Code会话内动态切换：（先进入Claude Code，然后输入/effort命令）
第三阶段：启动并验证连接
3.1 首次启动 Claude Code
Win11 可以在目录中点击右键菜单：
在终端中输入：
claude如果提示claude命令未找到，请检查【环境变量】是否包含C:\Users\你的用户名\.local\bin。
3.2 选择界面样式
首次启动时，系统会让你选择界面样式：
你可以根据个人喜好选择命令行主题，这不会影响核心功能。
3.3 信任工作目录
接下来，Claude Code 会询问是否信任当前工作目录：
选择Yes, I trust this folder以允许 Claude Code 在当前目录中读取和写入文件。
3.4 首次提问验证
现在，尝试向 Claude Code 提问，验证连接是否成功：
输入一个问题，比如"你是什么模型？"。
如果看到类似以下的成功响应，说明配置完成：
第四阶段：切换模型（按需使用）
4.1 了解 DeepSeek V4 模型
原有的 deepseek-chat 和 deepseek-reasoner 模型名将于 2026/07/24 弃用，建议升级使用新版 V4 系列模型：
| 模型名 | 特点 | 适用场景 |
|---|---|---|
deepseek-v4-flash | 高速响应，非思考模式 | 日常对话、简单问答、快速迭代 |
deepseek-v4-pro | 高性能，支持思考模式 | 复杂代码生成、深度推理、数学问题 |
4.2 切换模型的方法
方法1：启动时指定模型
claude--modeldeepseek-v4-pro如果在启动时指定不支持的模型名称，会出现如下情况：
方法2：启动后使用命令切换到指定模型
在 Claude Code 交互界面中输入：
/model deepseek-v4-pro如果在 Claude code 配置文件中未配置 deepseek-v4-pro 模型名称，这种方式可以快速切换到此模型。
方法3：启动后选择模型
/model如果需要Sonnet、Haiku、Opus等完整配置，请参考章节：【2.3 可选：添加进阶配置】
第五阶段：探索更多功能
5.1 查询可用技能
Claude Code 支持扩展多种技能（Skills），你可以直接提问查询/安装：
指令： 帮我搜索和安装 docx 技能，如果已安装请忽略
故障排查
问题1：启动时提示 “Unable to connect to Anthropic services”
原因：Claude Code 默认尝试连接 Anthropic 官方服务，而你的网络环境可能无法直接访问。
解决：确认已按第二阶段配置ANTHROPIC_BASE_URL指向https://api.deepseek.com/anthropic。
问题2：遇到 401 未授权错误
排查步骤：
- 检查
settings.json中的ANTHROPIC_AUTH_TOKEN是否已替换为你的真实 API Key - 检查 API Key 是否包含多余空格或换行
- 确认 API Key 是否已激活（新创建的 Key 可能需要几分钟生效）
- 确认 Key 没有被删除或过期
常见问题解答
Q1: 除了 DeepSeek，还能配置其他模型吗？
A: 可以。Claude Code 支持几乎所有的国产主流大模型，你只需要修改 请求地址、API Key 和 模型名称 参数即可。具体如何配置参考相应大模型的官方配置手册。例如：
- 火山方舟：Claude Code–火山方舟-火山引擎
- 智谱： Claude Code - 智谱AI开放文档
- MiniMax：Claude Code - MiniMax API Docs
- 阿里云百炼：Claude Code - 阿里云百炼文档
Q2: 如何确保 API Key 的安全？
A: 建议：
- 不要将 API Key 提交到版本控制系统（如 Git）
- 使用环境变量存储敏感信息
- 定期轮换 API Key
参考：https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
温馨提示：AI 技术发展迅速，本文基于当前版本编写，具体配置方法可能随软件更新而变化。建议关注 Claude Code 和 DeepSeek 的官方更新信息。