Claude Code × DeepSeek V4：从零开始配置与调用实战

本文介绍了如何在Claude Code命令行工具中配置国产DeepSeek大模型。主要内容包括：获取DeepSeek API Key的步骤；配置Claude Code连接DeepSeek的方法，包括基础配置和进阶参数设置；以及启动验证连接的流程。文章详细说明了模型映射策略、上下文窗口标识和推理档位等关键配置项，并提供了图文操作指南，帮助用户快速上手使用DeepSeek模型替代Claude官方服务。

Quz

880人浏览 · 2026-05-19 07:00:00

Quz · 2026-05-19 07:00:00 发布

准备工作

在开始之前，请确保你已经具备以下条件：

已安装 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 --model deepseek-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 的官方更新信息。

AI Agent技术社区

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

更多推荐

让 Codex 桌面版拥抱 DeepSeek-V4：协议桥接与模型网关接入实践

4SAPI 提供了一套标准的 Chat Completions 接口，完全兼容 DeepSeek V4 Pro 等模型，使用时只需将 base URL 和密钥替换为平台分配的值即可。这样一来，既保留了桥接层的协议转换能力，又获得了网关带来的额外弹性。这样的模型网关，则进一步提升了链路的稳定性和密钥管理的便捷度，尤其适合团队或对服务可用性有更高要求的场景。│Codex 桌面版│ ──────────

AI Agent技术社区

别再迷信“突破限制”：Gemini 3.5-flash 边界测试实战复盘

AI Agent技术社区

Hermes Agent 上下文压缩机制深度剖析：长对话场景下的有损压缩策略

大语言模型的上下文窗口是有限资源。在长对话场景中，Token 数量不可避免地逼近模型的上下文长度上限，此时系统面临两难选择：截断历史导致信息丢失，或超出限制导致 API 报错。Hermes Agent 的上下文压缩引擎（`ContextCompressor`）实现了一套三阶段有损压缩算法，在保持对话连续性的同时将 Token 消耗控制在安全阈值内。本文从源码层面详细分析该机制的算法设计、边界处理、