
Claude Code 是 Anthropic 推出的最强AI编程助手,被誉为”目前最强大的Agent框架”。但国内用户一直面临三道坎:下载需要翻墙、注册需要海外手机号、订阅需要$20/月。
今天这篇保姆级教程,手把手教你在国内网络环境下,零门槛使用 Claude Code + DeepSeek。无需科学上网,无需海外信用卡,按量付费,成本只要官方订阅的1/10。
一、方案原理:为什么这样能行?
Claude Code 本身只是一个”壳”,它背后调用的AI模型是可以替换的。官方默认调用 Anthropic 的 Claude 模型,但 Claude Code 支持标准的 Anthropic API 协议。
DeepSeek 提供了 Anthropic 兼容的API端点,这意味着我们可以让 Claude Code “以为”自己在调用 Claude 模型,实际上调用的是 DeepSeek V4 Pro。
这样做的好处:
- ✅ 国内直连:DeepSeek服务器在国内,延迟<100ms
- ✅ 按量付费:用多少付多少,无需$20/月订阅
- ✅ 支付宝/微信充值:国内支付方式
- ✅ 效果接近:DeepSeek V4 Pro 编程能力接近 Claude 4 Sonnet
二、准备工作
1. 获取 DeepSeek API Key
- 访问 platform.deepseek.com
- 用手机号注册账号(国内手机号即可)
- 进入「API Keys」页面,点击「创建API Key」
- 复制生成的 sk- 开头的密钥(注意:只显示一次,务必保存)
- 在「充值」页面用支付宝/微信充值(建议先充10元试用)
2. 确认系统环境
- Windows:Windows 10/11(本文以Windows为主)
- macOS:10.15+
- Linux:Ubuntu 20.04+ / Debian 10+
三、安装步骤(Windows版)
第一步:安装 Node.js
Claude Code 基于 Node.js 运行,需要先安装 Node.js 18+。
- 访问 nodejs.org,下载左边的 LTS(长期支持版)
- 双击安装包,一路点击”Next”直到完成
- 验证安装:打开 PowerShell,输入 node -v,应显示类似 v22.x.x
国内加速:如果官网下载慢,可以使用国内镜像 nodejs.org.cn
第二步:配置 npm 国内镜像
npm 默认从国外服务器下载,国内访问慢。配置淘宝镜像加速:
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置
npm config get registry
# 应输出 https://registry.npmmirror.com
第三步:安装 Claude Code
打开 PowerShell,执行:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
等待安装完成(约1-3分钟),然后验证:
claude --version
# 应输出版本号,如 v2.1.x
常见问题:如果提示”无法识别claude命令”,关闭PowerShell重新打开即可。
第四步:配置 DeepSeek 接入(关键步骤)
Claude Code 的配置文件位于用户目录下。我们需要创建/修改配置文件,让 Claude Code 连接到 DeepSeek。
方法A:通过 settings.json 配置(推荐)
- 打开文件资源管理器,在地址栏输入 %USERPROFILE%\.claude 回车
- 如果文件夹不存在,手动创建 .claude 文件夹
- 在 .claude 文件夹内创建 settings.json 文件
- 用记事本打开,粘贴以下内容(替换为你的API Key):
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-v4-pro",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro"
}
}
- 保存文件
方法B:通过环境变量配置(临时)
如果只想临时使用 DeepSeek,可以在每次启动前设置环境变量:
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的DeepSeek-API-Key"
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_MODEL = "deepseek-v4-pro"
claude
第五步:创建辅助配置文件
为了避免启动时报错,还需要在用户目录下创建 .claude.json 文件:
- 打开文件资源管理器,进入 %USERPROFILE%(即 C:\Users\你的用户名)
- 创建文件 .claude.json
- 内容如下:
{
"hasCompletedOnboarding": true
}
四、启动使用
1. 进入项目目录
# 创建测试项目
mkdir my-project
cd my-project
2. 启动 Claude Code
claude
首次启动会进行一些初始化,稍等片刻即可进入交互界面。
3. 验证配置
在 Claude Code 中输入:
/status
查看输出中的 Anthropic base URL 是否为 https://api.deepseek.com/anthropic,确认配置生效。
4. 开始对话
直接输入你的需求,例如:
帮我创建一个Python脚本,实现批量重命名文件的功能
Claude Code 会分析需求、规划步骤、编写代码,并询问你是否执行。
五、macOS/Linux 安装步骤
macOS
# 1. 安装 Node.js(使用 Homebrew)
brew install node
# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 3. 创建配置目录和文件
mkdir -p ~/.claude
# 4. 编辑配置文件
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-v4-pro"
}
}
EOF
# 5. 创建辅助配置
echo '{"hasCompletedOnboarding": true}' > ~/.claude.json
Linux
# 1. 安装 Node.js(Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 2-5步与macOS相同
六、进阶:使用 CC-Switch 管理多模型
如果你想在 DeepSeek、智谱GLM、MiniMax 等多个国产模型间快速切换,可以使用 CC-Switch 图形化工具。
安装 CC-Switch
- 访问 GitHub Releases 页面
- 下载 CC-Switch-vX.X.X-Windows-x64.msi
- 双击安装
配置模型
- 打开 CC-Switch
- 点击右上角”+”添加供应商
- 选择”DeepSeek”,输入 API Key
- 选择模型版本(推荐 V4 Pro)
- 点击”保存”
以后想切换模型,只需在 CC-Switch 里点一下即可,无需手动改配置文件。
七、常用命令速查
| 命令 | 功能 |
|---|---|
| /status | 查看当前配置状态 |
| /model | 切换AI模型 |
| /clear | 清空当前对话 |
| /exit | 退出 Claude Code |
| /help | 查看所有命令 |
八、三种工作模式
Claude Code 提供三种权限模式,根据需求选择:
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Ask(询问) | 每次修改前都询问确认 | 新手、重要项目 |
| Code(代码) | 自动接受文件编辑,命令需确认 | 日常开发 |
| Plan(计划) | 先制定详细计划,执行前等待批准 | 复杂任务 |
在输入框旁边的下拉菜单中切换模式。
九、费用参考
DeepSeek V4 Pro 的定价(截至2026年):
| 项目 | 价格 |
|---|---|
| 输入(Input) | 约 0.002-0.004 / 1K tokens |
| 输出(Output) | 约 0.008-0.016 / 1K tokens |
实际使用成本:
- 轻度使用(每天1-2小时):约 5-10/月
- 中度使用(每天3-5小时):约 20-50/月
- 重度使用(全天使用):约 100-200/月
相比 Claude Pro $20/月(约145)的固定订阅,按量付费对大多数用户更划算。
十、常见问题
Q1: 提示 “Unable to connect to Anthropic services”
解决:检查 settings.json 中的 ANTHROPIC_BASE_URL 是否为 https://api.deepseek.com/anthropic,注意末尾不要有斜杠。
Q2: 提示 “Invalid API Key”
解决:检查 API Key 是否复制完整(以 sk- 开头),以及 DeepSeek 账户是否有余额。
Q3: 中文显示乱码
解决:PowerShell 中执行 chcp 65001 切换到 UTF-8 编码。
Q4: 如何更新 Claude Code?
解决:执行 npm update -g @anthropic-ai/claude-code
Q5: 可以接入其他国产模型吗?
可以。智谱GLM、MiniMax、SiliconFlow 等平台都提供 Anthropic 兼容接口,配置方法类似,只需修改 ANTHROPIC_BASE_URL。
十一、写在最后
通过本文的方法,你可以在国内网络环境下零门槛使用 Claude Code,享受顶级AI编程助手的能力,同时避免高昂订阅费用。
Claude Code + DeepSeek 的组合,既保留了 Claude Code 强大的Agent框架和工程化能力,又解决了国内访问和成本问题,是目前性价比最高的AI编程方案之一。
如果你在使用过程中遇到问题,欢迎在评论区留言交流。
