Claude Code 国内直连实战:DeepSeek 做后端,一行命令开箱即用

2026-05-18 14 预计阅读时间:1 分钟
来源:oschina.net AI 摘要 原文链接

免责声明:本文为 AI 摘要整理,建议结合原文阅读。摘要可能省略上下文、版本差异或边界条件,不作为官方说明。

预计阅读时间:8 分钟

国内开发者想用 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 的端点,再把模型标识换一下,其余流程完全不变。

一行命令安装

脚本做的事情很明确:

  1. 安装 Claude Code CLI
  2. 配置 DeepSeek API endpoint 和 key
  3. 写入环境变量,让后续每次启动自动走 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 后端,省的不是折腾的时间,而是思路连续性本身——这对写代码的人来说,比什么都值钱。


相关推荐