⚠️ 免责声明：本教程仅记录技术实现路径，供学习研究参考。请读者自行评估风险，合理使用。

适用人群：已了解 OpenClaw 基础、希望在 Windows 上通过 WSL2 部署 Claude Code 的开发者。
前置知识：基本的命令行操作，建议先完成第一篇 OpenClaw 教程的环境准备部分。
涉及内容：Claude Code 定位与特点、禁令背景与应对方案、DeepSeek API 接入、代理配置、交互模式启动与使用。

一、Claude Code 是什么？它和 OpenClaw 有什么不同？

1.1 Claude Code 的定位

Claude Code 是 Anthropic 推出的旗舰级代理式编程工具（Agentic Coding Tool） 。官方描述它能读取代码库、跨文件修改、运行测试、交付已提交的代码。它的核心循环是：收集上下文 → 采取行动 → 验证结果。

与普通 AI 编程助手不同，Claude Code 深度融入终端工作流——读项目、跑测试、分析报错、看 diff、管提交、记规则。它的真正价值在于工程化协作：从需求理解到文档沉淀，参与完整的工程链路。

一句话理解：Claude Code 不是一个“给你建议”的聊天机器人，而是一个能直接在你的终端里动手干活的 AI 代码工程师。（比如在处理硕士论文之类的项目代码时）

1.2 Claude Code 与 OpenClaw 的核心区别

很多人在接触这两个工具时会产生混淆（我自己一开始也是），但它们的定位完全不同：

维度	OpenClaw（小龙虾）	Claude Code（CC）
核心定位	通用 AI 智能体（万能管家）	编码工具（结对编程工程师）
擅长领域	操作电脑、收发邮件、管理文件、浏览器自动化	理解代码库、跨文件重构、调试 Bug、运行测试
工作环境	整个电脑系统	聚焦于代码仓库
模型绑定	中立框架，支持多家模型	来自模型厂商，深度绑定 Anthropic 算力
网络依赖	可通过本地算力实现物理断网运行	必须与 Anthropic 服务器保持 HTTPS 长连接
知识存储	Markdown 文件，Agent 启动时加载	MCP 协议的 tool 机制，按需加载执行

简单总结：

• OpenClaw 像一个管家——你让它“帮我整理桌面文件”“每天9点提醒我”，它能做到。

• Claude Code 像一个编程工程师——你让它“分析这个项目的内存泄漏原因”“把整个模块从 V1 重构到 V2”，它也能做到。

它们不是替代关系，而是分层协作。对于你的硕士论文代码复现任务，Claude Code 是更合适的工具。

二、背景：使用 Claude Code 会遇到障碍？

受限于审核，背景部分做了删减。

三、我们的应对方案：Claude Code 身体 使用第三方 API 端点

既然 Claude Code 的“身体”功能强大，但官方“大脑”（Anthropic 模型）在国内无法使用，解决方案就是：保留 Claude Code 的执行能力（身体），将“大脑”替换为国产大模型（DeepSeek） 。

3.1 方案原理

通过设置环境变量 ANTHROPIC_BASE_URL，告诉 Claude Code 客户端去访问 DeepSeek 提供的 Anthropic Messages API 兼容端点：

https://api.deepseek.com/anthropic

同时将 ANTHROPIC_API_KEY 从 Anthropic 的 Key 替换为你在 DeepSeek 平台申请的 API Key。

这样，Claude Code 以为自己连接的是 Anthropic 官方服务，实际上所有请求都被转发到了 DeepSeek。

3.2 为什么选择 DeepSeek？

• 协议兼容：DeepSeek 提供了 Anthropic Messages API 兼容端点

• 国内直连：不需要额外的 VPN 或代理

• 成本低廉：相比 Anthropic 官方 API 便宜数十倍

• 你已有 API Key：你在第一篇教程中已经申请过了

3.3 补充说明

⚠️ 本教程仅记录技术实现路径，供学习研究参考。Anthropic 的服务条款请自行遵守。

四、环境准备

4.1 前提条件

• 已完成第一篇教程中的 WSL2 + Ubuntu 环境配置

• 已安装 Node.js（版本 18 或更高）

• 已拥有 DeepSeek API Key（来自第一篇教程的 4.1 节）

4.2 验证 Node.js 环境

在 Ubuntu 终端中执行：

node --version  # 应显示 v18.x.x 或更高
npm --version   # 应显示对应版本

如果未安装，参考第一篇教程的 3.1 节进行安装。

五、安装 Claude Code

5.1 通过 NPM 安装（推荐方式）

在 Ubuntu 终端中执行：

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

如果下载速度慢，可以先设置国内镜像：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

5.2 验证安装

claude --version

如果显示版本号（如 2.1.201），说明安装成功。

注意：命令名称是 claude，不是 claude-code——这是官方设计的简短名称。

六、配置 DeepSeek API（核心步骤）

6.1 为什么需要这一步？

Claude Code 默认会连接 Anthropic 的官方 API。我们需要通过环境变量，将请求重定向到 DeepSeek 的兼容端点。

6.2 设置环境变量（临时方式）

在 Ubuntu 终端中执行：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="你的DeepSeek API Key

注意：这种方式仅对当前终端会话有效，关闭终端后需要重新设置。

6.3 永久生效（推荐）

将环境变量写入 ~/.bashrc：

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="你的DeepSeek API Key"' >> ~/.bashrc
source ~/.bashrc

6.4 验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

如果输出正确，说明配置成功。

七、非交互模式测试（验证 API 是否连通）

在配置完成后，建议先用非交互模式测试 API 是否正常工作：（这只是第一步，交互模式才是我们的最终目标）

claude -p "你好，请简单介绍一下你自己"

如果 DeepSeek API 配置正确，你会看到 Claude Code 返回的回复——即使在国内网络环境下，这一步也能成功。

如果 DeepSeek API 配置正确，你会看到 Claude Code 返回的回复——即使在国内网络环境下，这一步也能成功。

为什么这一步很重要？ 非交互模式 (-p) 只处理核心 API 请求，不涉及启动检查。如果这一步成功，说明 DeepSeek API 配置完全正确。如果这一步也失败，说明环境变量或 API Key 配置有误。

八、交互模式启动与代理配置

8.1 为什么交互模式需要额外配置？

非交互模式能用，但交互模式 (claude) 会卡住——因为 Claude Code 在启动时会进行版本更新检查、遥测数据上报等额外请求，这些请求是硬编码的，不会受 ANTHROPIC_BASE_URL 影响，仍然会尝试连接 Anthropic 官方服务器。

8.2 解决方案：使用 claude-shadow 本地代理

claude-shadow 是一个本地代理工具，它会拦截 Claude Code 发出的所有网络请求（包括那些硬编码的启动检查），并转发到你配置的 API。

安装 claude-shadow：

npm install -g claude-shadow

启动代理并配置：

claude-shadow

启动后会进入交互式配置向导：

1. 选择 provider：preset:deepseek

2. 输入 DeepSeek API Key

3. 选择模型：deepseek-v4-pro（或你喜欢的模型）

4. 设置代理端口：直接按回车使用默认的 6666

看到 Proxy running on http://localhost:6666 的提示后，保持这个终端窗口打开。

8.3 在新终端中启动 Claude Code

打开另一个 Ubuntu 终端，执行：

export ANTHROPIC_BASE_URL="http://127.0.0.1:6666"
export ANTHROPIC_API_KEY="任意值（代理会忽略）"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

8.4 完成首次启动配置

首次进入交互模式时，Claude Code 会让你选择终端主题：

• Dark mode（推荐，直接按回车即可）

• 或其他主题（用方向键选择后按回车）

然后会显示安全提示，按 回车 继续。

最后会询问是否信任当前文件夹：

• 选择 1. Yes, I trust this folder（按回车）

进入后，你会看到 ❯ 提示符，可以开始输入问题了。

九、使用 Claude Code

9.1 基本用法

在 ❯ 提示符后直接输入自然语言指令，例如：

请分析当前目录下的代码结构 / 请阅读这个项目的所有文件，总结功能和依赖

9.2 常用命令

命令	作用
/init	在项目根目录创建 CLAUDE.md 配置文件
/clear	清空当前对话历史
/theme	重新选择终端主题
exit 或 Ctrl+C	退出 Claude Code

9.3 关于 CLAUDE.md

/init 命令会生成一个 CLAUDE.md 文件，你可以把项目背景、技术栈、编码规范等信息写进去。Claude Code 在每次启动时会自动读取这个文件，相当于给 AI 一份项目说明书。

9.4 注意事项

• Claude Code 会直接读取和修改文件，建议在备份副本上测试

• 每次修改前会显示 diff 差异，需要按 y 确认才会执行

• 关注 DeepSeek 平台的用量和余额

9.5 日常启动流程（第二天及以后）

每次使用前，先确认两件事：

1. DeepSeek 账户余额充足（登录平台查看）

2. 网络正常（WSL2 能访问外网）

标准启动流程（三步） ：

第一步：启动代理

打开 Ubuntu 终端，执行：

claude-shadow

看到 Proxy running on http://localhost:6666 后，保持这个终端窗口打开（不要关闭）。

第二步：设置环境变量并启动 CC

再打开一个新的 Ubuntu 终端（Ctrl + Shift + T 新建标签页或重新打开一个窗口），执行：

export ANTHROPIC_BASE_URL="http://127.0.0.1:6666"
export ANTHROPIC_API_KEY="任意值"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

第三步：确认进入项目目录

如果不在你的项目目录下，先 cd 进去再启动：

cd ~/projects/你的项目文件夹
claude

快捷方式（可选） ：

如果你觉得每次都要 export 很麻烦，可以把环境变量写入 ~/.bashrc（只写 ANTHROPIC_BASE_URL，API_KEY 代理会忽略），这样每次打开终端自动生效：

echo 'export ANTHROPIC_BASE_URL="http://127.0.0.1:6666"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.bashrc
source ~/.bashrc

之后每天只需要两步：

1. 打开终端 → claude-shadow（保持运行）

2. 打开新终端 → cd 项目目录 → claude

注意事项：

• 代理终端不要关闭：claude-shadow 所在的终端必须保持运行，关闭后 CC 无法连接

• 两个终端：一个跑代理，一个用 CC（可以开多个 CC 终端同时工作）

• 如果第二天代理连不上：可能端口被占用，claude-shadow 会提示，换个端口重新配置即可

十、常见问题与解决方案

10.1 claude -p 能用，但 claude 交互模式连不上

现象：非交互模式正常返回，但交互模式一直卡住或报错。

原因：交互模式启动时有硬编码的版本检查、遥测等请求，这些请求不受 ANTHROPIC_BASE_URL 影响。

解决方案：使用 claude-shadow 代理（见第八节）。

10.2 claude: command not found

原因：Node.js 全局安装路径未加入 PATH。

解决方案：

# 查找 claude 安装位置
which claude
# 或重新安装
npm install -g @anthropic-ai/claude-code

10.3 环境变量设置了但未生效

原因：环境变量未正确导出，或在不同终端中未继承。

解决方案：

• 确保在同一终端中执行 export 和 claude

• 或将环境变量写入 ~/.bashrc 并执行 source ~/.bashrc

10.4 DeepSeek API 返回错误

可能原因：

• API Key 无效或余额不足

• 网络无法访问 api.deepseek.com

排查步骤：

1. 登录 DeepSeek 开放平台确认余额

2. 测试网络：curl -I https://api.deepseek.com

3. 确认环境变量：echo $ANTHROPIC_BASE_URL

十一、补充说明

11.1 进一步说明

本教程记录的方案，核心思路是将 Claude Code 的“身体”与 Anthropic 的“大脑”解耦。通过环境变量将请求重定向到 DeepSeek 的兼容端点。

但请注意：本教程仅供学习研究参考。

11.2 Claude Code vs Claude 网页版

• Claude Code：终端工具，直接操作代码库，适合编程任务

• Claude 网页版：通用对话，适合日常问答和文档阅读

两者使用不同的网络通道，网页版能访问不代表终端版也能访问。

11.3 进一步学习资源

• Claude Code 官方文档

• DeepSeek 开放平台

以上是 Claude Code 在 Windows WSL2 环境下的完整安装与配置教程。核心价值在于两点：

1. 说清楚 CC 是什么：它是一个“能动手干活的 AI 工程师”，和 OpenClaw 的“万能管家”定位完全不同，两者是协作关系而非替代关系。

2. 说清楚限制与应对：我们通过“CC 身体 + DeepSeek 大脑”的方案避免限制。