国内无需代理!Claude Code + DeepSeek 完整配置教程(Windows)

作者前言:如果你在国内想用 Claude Code,一定会遇到两个问题:1. 网络无法访问 Anthropic 官方 API;2. 官方 API 费用昂贵。本文详细介绍如何通过 DeepSeek 的 Anthropic 兼容接口,让 Claude Code 在国内零障碍运行,而且费用比官方便宜很多。


一、环境要求

在开始之前,请确保你的电脑满足以下条件:

  • 操作系统:Windows 10/11
  • Node.js:18 版本及以上
  • Git for Windows:需要安装(下载地址:https://git-scm.com/download/win)

检查 Node.js 是否已安装

打开 PowerShell,输入以下命令:

node --version
npm --version

如果显示版本号(例如 v22.12.0),说明 Node.js 已安装。


二、安装 Claude Code

打开 PowerShell,执行以下命令:

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

安装完成后,验证是否成功:

claude --version

如果显示版本号(例如 2.1.145),说明安装成功。


三、配置环境变量(关键步骤)

3.1 获取 DeepSeek API Key

  1. 访问 DeepSeek Platform
  2. 注册并登录账号
  3. 进入「API Keys」页面,点击「Create new API key」
  4. 复制生成的 Key(形如 sk-xxxxxxxx
  5. 建议充值一定金额,否则调用时会报错 402 Insufficient Balance

3.2 配置环境变量

打开 PowerShell,按顺序执行以下命令(注意:这是 Windows PowerShell 的格式):

# 设置 API 端点
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")

# 设置 API Key(替换为你的 DeepSeek API Key)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的API Key", "User")

# 设置默认模型(推荐用 deepseek-v4-pro,复杂任务用 deepseek-v4-flash)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "User")

# 子代理使用轻量模型
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-flash", "User")

# 最高推理强度(可选)
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")

3.3 解决 PATH 问题(重要)

如果执行 claude 命令时提示找不到该命令,需要将 npm 全局安装目录添加到 PATH:

$npmPrefix = "C:\Users\zhang\.workbuddy\binaries\node\versions\22.12.0"
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($currentPath -notlike "*$npmPrefix*") {
    [Environment]::SetEnvironmentVariable("Path", "$currentPath;$npmPrefix", "User")
    Write-Host "PATH 已添加"
}

提示:将命令中的用户名替换为你实际的用户名(查看方法:打开文件资源管理器,地址栏显示的 C:\Users\xxx 中的 xxx 就是你的用户名)。


四、验证配置是否成功

4.1 方法一:重启 PowerShell

关闭当前 PowerShell 窗口,重新打开一个新的,然后输入:

claude

如果看到类似以下界面,说明配置成功:

Claude Code v2.1.145
Model: deepseek-v4-pro
Billing: API Usage Billing

4.2 方法二:快速测试

在新打开的 PowerShell 中输入:

claude --print "你好"

如果 AI 回复了消息,说明一切正常。


五、常见问题排查

Q1:执行 claude 命令提示找不到

原因:npm 全局安装目录未添加到 PATH。

解决:参考本文「3.3 解决 PATH 问题」部分。

Q2:提示 402 Insufficient Balance

原因:DeepSeek API 账号余额不足。

解决:登录 DeepSeek Platform 充值。

Q3:提示 401 UnauthorizedAPI Error

原因:使用了错误的环境变量名。

解决:确认使用的是 ANTHROPIC_AUTH_TOKEN,而不是 ANTHROPIC_API_KEY

Q4:连接超时或无响应

原因:首次调用可能较慢,或者网络问题。

解决

  • 等待 30 秒以上
  • 检查网络连接
  • 确认 ANTHROPIC_BASE_URL 设置为 https://api.deepseek.com/anthropic

Q5:模型名称写什么?

DeepSeek 支持以下模型名称:

模型名称 特点 适用场景
deepseek-v4-pro 深度推理,能力强 复杂架构设计、难题解答
deepseek-v4-flash 快速响应 日常编码、简单任务

六、费用说明

使用 DeepSeek API 的费用比 Anthropic 官方便宜很多:

模型 输入(每百万 tokens) 输出(每百万 tokens)
deepseek-v4-pro 约 $0.5 约 $2
deepseek-v4-flash 约 $0.1 约 $0.5

相比 Claude 官方定价(输入 $3,输出 $15),DeepSeek 的性价比非常高。


七、总结

通过以上步骤,你已经成功配置了:

  • ✅ Claude Code v2.1.145
  • ✅ DeepSeek API(Anthropic 兼容接口)
  • ✅ 国内网络直连,无需代理
  • ✅ 永久环境变量配置,重启后依然有效

现在你可以在终端中直接使用 claude 命令,享受 AI 编程助手的便利了!


附:完整环境变量清单

如果你需要查看当前所有配置,可以执行:

[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_MODEL", "User")

版权声明:本文首发于 CSDN,转载需注明出处。

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐