Cairn
登录 注册
← 返回博客

在 Windows 上用 Claude Code 接入 DeepSeek

在 Windows 上用 Claude Code 接入 DeepSeek

很多人第一次看到这个组合会困惑：既然想用的是 DeepSeek，为什么还要安装 Claude Code呢？

答案是：Claude Code 是终端里的编程客户端，DeepSeek 才是实际回答和生成代码的模型后端。

DeepSeek 官方提供了 Anthropic API 兼容接口。只要把 Claude Code 的接口地址、认证令牌和模型名改为 DeepSeek 的配置，Claude Code 发出的请求就会交给 DeepSeek 处理；不需要 Anthropic API Key，也不会调用 Claude 模型。

本文以 Windows 为例，从安装到第一次在项目中使用，完整走一遍这套配置。

本文最后核对：2026-07-18。模型名称和 API 能力会更新，实际使用时以 DeepSeek API 文档 为准。

一、先分清客户端与模型

这套组合里有三个角色：

你在终端输入需求
        │
        ▼
Claude Code（读取项目、修改文件、运行命令）
        │  Anthropic 兼容 API
        ▼
DeepSeek API（真正推理与生成内容）
        │
        ▼
DeepSeek-V4-Pro / DeepSeek-V4-Flash

Claude Code 负责理解工作目录、展示差异、请求命令执行权限等“本地编程助手”能力；DeepSeek 负责模型推理。两者并不冲突，就像浏览器和搜索引擎是不同层次的工具。

DeepSeek 官方已将 Claude Code 列为支持的编程工具，并给出了 Windows 环境变量配置。官方集成说明

二、开始前需要什么

准备以下内容：

  • Windows 10 或 Windows 11。
  • Node.js 18 或更高版本。
  • Git for Windows。它让 Claude Code 能在 Windows 上使用 Git Bash；即使不装，客户端也会退回使用 PowerShell。
  • DeepSeek 开放平台账号、API Key 和可用余额。

打开 PowerShell，先确认 Node.js 和 npm 可用：

node --version
npm --version

只要能显示版本号，就可以继续。若提示命令不存在，先安装 Node.js 的 LTS 版本，完成后重新打开 PowerShell。

三、安装 Claude Code 客户端

在 PowerShell 或 Windows Terminal 中执行：

npm install -g @anthropic-ai/claude-code
claude --version

claude --version 显示版本号，就说明客户端安装成功。

这里安装的 npm 包名称里虽然带有 anthropic，但它只是 Claude Code 客户端的发布包名。下一节会把模型后端明确切换成 DeepSeek。

如果 PowerShell 提示 claude 不是命令，先关闭当前窗口，再重新打开一个 PowerShell 后重试。仍然失败时执行：

npm prefix -g
where.exe claude

通常是 npm 的全局可执行目录没有进入 Windows 的 PATH；确认 Node.js 安装正常后重开终端即可。

四、创建 DeepSeek API Key

登录 DeepSeek 开放平台，创建一个 API Key。创建成功后立即复制并妥善保存；多数平台只会完整展示一次。

API Key 等同于密码。请遵守这几条：

  • 不发送到聊天记录、截图、邮件或群聊。
  • 不写进 Git 仓库、代码、Markdown、.env 或前端文件。
  • 不把 Key 提交到任何分支，即使仓库是私有的。
  • 怀疑泄露时，立刻在平台删除旧 Key 并创建新 Key。

DeepSeek API 是按量计费的。开始大量使用前，到平台确认账户余额和当前模型价格；价格和模型能力都可能变化。

五、让 Claude Code 改用 DeepSeek

在同一个 PowerShell 窗口中执行下面的配置。将 你的 DeepSeek API Key 替换成真实 Key，保留引号，删除示例文字。

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "你的 DeepSeek API Key"
$env:ANTHROPIC_MODEL = "deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL = "max"

这些变量名称以 ANTHROPIC_ 开头，是因为 Claude Code 使用 Anthropic 格式的接口；真正决定请求去向的是：

ANTHROPIC_BASE_URL = https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN = DeepSeek API Key

前者把请求地址指向 DeepSeek，后者用 DeepSeek Key 认证。因此，这不是在使用 Anthropic 服务。

上面配置的模型分工是：

用途 模型 原因
主要编码、复杂分析 deepseek-v4-pro 用于需要更强推理的主任务。
子任务、简单查询 deepseek-v4-flash 响应更快，适合轻量任务。

环境变量只在当前 PowerShell 会话存在。关闭窗口后它们会自动失效，API Key 不会被长期写入系统设置。这比把 Key 写进项目文件更安全；下次使用时重新执行本节命令即可。

不要执行 Claude Code 的 Anthropic 登录流程。配置了 DeepSeek Key 后，认证应由 DeepSeek 完成。

六、在项目中启动第一次会话

仍在刚才配置好变量的同一个窗口中，进入项目根目录。下面以项目在桌面为例：

cd "$HOME\Desktop\cairn"
claude

仓库不在桌面时，替换为真实路径即可，例如 D:\code\cairn。

第一次对话不要直接让它大改代码。一个稳妥的开始方式是：

请先阅读 AGENTS.md 和相关代码，不要修改文件。
说明这个项目的技术栈、当前分支和你建议的实现计划。

确认计划后，再授权它执行具体修改。修改完成后，始终自己检查差异：

git status
git diff

AI 可以帮助分析、写代码和运行检查，但不应自行提交、推送、合并分支或部署生产环境。这些涉及代码历史和线上状态的操作，应由开发者明确决定。

七、日常使用方式

每次打开新 PowerShell 时，按下面顺序操作：

  1. 打开 PowerShell。
  2. 重新设置第五节的 DeepSeek 环境变量。
  3. cd 进入项目目录。
  4. 执行 claude。
  5. 开始前先说明任务范围和限制，例如“只修改前端模板和 CSS，不提交代码”。
  6. 完成后用 git diff 审查，再决定是否保留改动。

这看起来比把 Key 永久保存方便性差一点，但能明显降低 API Key 被误传、误提交或被其他本机程序读取的风险。

更新客户端时执行：

npm update -g @anthropic-ai/claude-code
claude --version

DeepSeek 旧模型别名会逐步淘汰。配置模型时优先使用当前官方文档列出的 deepseek-v4-pro 与 deepseek-v4-flash，不要继续依赖 deepseek-chat 或 deepseek-reasoner。

八、常见问题

1. claude 不是内部或外部命令

先重新打开 PowerShell，再运行：

claude --version

还不行就检查：

npm prefix -g
where.exe claude

确认 Node.js 的全局 npm 可执行目录已加入 PATH。不要从非官方来源下载同名可执行文件。

2. 认证失败、401 或提示没有凭证

检查以下两项是否在启动 claude 的同一个 PowerShell 中设置过：

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN

第一个应显示 https://api.deepseek.com/anthropic；第二个不应为空。若 Key 已失效或泄露，去 DeepSeek 开放平台创建新的 Key，再重新设置变量。

3. 余额不足、限流或请求失败

DeepSeek 会根据 Key 对应的账户进行计费和限流。到平台检查余额、模型可用性和错误码；遇到临时服务错误可以稍后重试。不要把 Key 贴给他人排错。

4. 重开终端后又不能用了

这是预期行为：环境变量只存在于原来的 PowerShell 会话。重新打开终端后，重新执行第五节的配置命令即可。

5. Windows 与 WSL2 混用

PowerShell 和 WSL2 是两个独立环境：在哪个环境运行 claude，就在哪个环境安装客户端、设置环境变量和保存 API Key。

如果项目在 WSL2 的 Ubuntu 中，改用 Bash 语法：

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN='你的 DeepSeek API Key'
export ANTHROPIC_MODEL=deepseek-v4-pro
claude

九、最后检查清单

开始使用前，确认下面几项：

  • node --version 与 npm --version 正常。
  • claude --version 正常。
  • 已在当前终端设置 DeepSeek 的接口地址和 API Key。
  • 项目目录正确，且已阅读项目的协作规则。
  • API Key 没有写入仓库或截图。
  • AI 只在明确授权的范围内修改文件。

做到这些，Claude Code 就只是一个顺手的终端工作台，而真正为代码任务提供推理能力的始终是 DeepSeek。

评论

暂无评论，来说点什么吧。

请先登录后再发表评论

去登录