国内开发者想用 Claude Code,撞上的不是技术墙,而是三道现实门槛:注册要海外手机号、API 调用必须翻墙、账号稍不留神就被封。折腾一圈下来,写代码的时间还没配环境的时间多。
最近社区出了一个一键脚本,思路很直接——Claude Code 前端不动,后端换成国内直连的 DeepSeek(兼容 Anthropic 协议),三道门槛一次清零。全平台可用,macOS / Windows / Linux 都行。
为什么 DeepSeek 能接?
Claude Code 本质上是一个 CLI 客户端,它跟后端通信走的是 Anthropic 的 Messages API 协议。DeepSeek 的 API 在请求格式上做了兼容——同样的 messages 端点、同样的 content 结构、同样的流式响应格式。区别只在 base URL 和模型名。
这意味着你不需要魔改 Claude Code 源码,只需要把请求目的地从 api.anthropic.com 指向 DeepSeek 的端点,再把模型标识换一下,其余流程完全不变。
一行命令安装
脚本做的事情很明确:
- 安装 Claude Code CLI
- 配置 DeepSeek API endpoint 和 key
- 写入环境变量,让后续每次启动自动走 DeepSeek
macOS / Linux 执行:
curl -fsSL https://raw.githubusercontent.com/anthropics/claude-code-bootstrap/main/setup-deepseek.sh | bash
Windows(PowerShell):
irm https://raw.githubusercontent.com/anthropics/claude-code-bootstrap/main/setup-deepseek.ps1 | iex
上面是示意命令结构。实际脚本地址以项目仓库最新 README 为准,执行前建议先
curl下来看一遍内容再跑。
脚本跑完后,终端里直接输入:
claude
就能进入 Claude Code 的交互界面,背后走的已经是 DeepSeek。
手动配置:理解原理才能灵活调整
如果你不想跑一键脚本,或者需要自定义配置(比如换模型、换代理地址),手动步骤也就三步。
第一步:安装 Claude Code
npm install -g @anthropic-ai/claude-code
要求 Node.js ≥ 18。没装 Node 的先:
# macOS (Homebrew)
brew install node
# Ubuntu / Debian
sudo apt install nodejs npm
第二步:拿到 DeepSeek API Key
去 platform.deepseek.com 注册,国内手机号直接注册,不需要翻墙。注册后在 API Keys 页面创建一个 key,复制保存。
第三步:写入环境变量
Claude Code 读取三个关键环境变量来决定后端行为:
# 写入 ~/.bashrc 或 ~/.zshrc(macOS/Linux)
export ANTHROPIC_API_KEY="你的DeepSeek API Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export ANTHROPIC_MODEL="deepseek-chat"
Windows 用户在 PowerShell profile 里加:
$env:ANTHROPIC_API_KEY = "你的DeepSeek API Key"
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com"
$env:ANTHROPIC_MODEL = "deepseek-chat"
改完后 source ~/.zshrc(或重启终端),直接运行 claude 即可。
实际使用:跟原版体验差异在哪
配好之后日常使用跟官方 Claude Code 几乎一样——项目目录下启动,让它读代码、改文件、跑测试:
cd my-project
claude
进入交互后:
> 帮我重构 utils.py 里的 parse_config 函数,加上类型校验和错误处理
> 给这个 Flask 项目写一个 Dockerfile,用多阶段构建减小镜像体积
> 跑一下 pytest,把失败的测试逐个修复
能做的:代码阅读、文件编辑、终端命令执行、多轮对话上下文保持——这些是 Claude Code CLI 本身的能力,跟后端是谁无关。
差异点:
| 维度 | Claude (官方) | DeepSeek 后端 |
|---|---|---|
| 模型能力 | Claude 3.5 Sonnet,长上下文强 | DeepSeek-V3,代码能力扎实但超长上下文略弱 |
| 响应速度 | 翻墙链路不稳定 | 国内直连,延迟低且稳定 |
| 费用 | Anthropic 定价,美元结算 | DeepSeek 定价,人民币结算,显著便宜 |
| 工具调用 | 完整支持 | 兼容协议,主流场景正常 |
简单说:日常写代码、改 bug、写配置,体验接近;需要超长文件一次性理解或极复杂推理时,DeepSeek 会比 Claude 3.5 Sonnet 稍弱。但考虑到零翻墙、低延迟、低成本,这个交换对大多数国内开发者是划算的。
进阶:JeecgBoot Skills 集成
一键脚本里还提到了 JeecgBoot Skills——这是一组面向低代码平台开发的预置技能包。如果你在用 JeecgBoot 做企业项目,可以让 Claude Code 直接理解平台的代码生成规则、表单配置约定、权限模型。
启用方式(脚本已自动集成的情况下):
claude --skills jeecgboot
进入后对话会自带 JeecgBoot 上下文,比如:
> 根据这张数据库表结构,生成完整的 CRUD 模块,包含前端页面和后端接口
它会按照 JeecgBoot 的代码生成规范输出,而不是给你一个通用 Spring Boot 模板。
采纳建议与风险清单
适合用的人:国内日常开发、不想折腾翻墙、对成本敏感、主要做中等复杂度的代码任务。
需要注意的点:
- 数据流向:你的代码上下文会发送到 DeepSeek 的 API 服务器。涉及敏感业务代码时,评估一下是否合规。
- 模型切换:环境变量配好之后是全局生效的。如果你同时有 Anthropic 官方 key,想临时切回,改
ANTHROPIC_BASE_URL为空即可回到默认地址。 - 版本兼容:DeepSeek 的协议兼容是主动适配,如果 Claude Code CLI 大版本升级改了请求格式,可能有短暂的不兼容窗口。关注项目仓库的更新日志。
- Key 安全:别把 API Key 硬编码在公开的 dotfiles 里。用
dotenv或系统密钥管理工具更稳妥。
快速检查清单:
- [ ] Node.js ≥ 18 已安装
- [ ] DeepSeek API Key 已获取并写入环境变量
- [ ] ANTHROPIC_BASE_URL 指向 https://api.deepseek.com
- [ ] ANTHROPIC_MODEL 设为 deepseek-chat(或 deepseek-reasoner)
- [ ] 终端重启后 claude 命令可正常启动
- [ ] 项目目录下测试一次代码修改任务,确认工具调用正常
翻墙用 Claude Code 是能跑,但每次网络抖动都在打断思路。换成 DeepSeek 后端,省的不是折腾的时间,而是思路连续性本身——这对写代码的人来说,比什么都值钱。