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

适用人群：已了解 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 在 Windows WSL2 环境下的完整安装与配置教程。核心价值在于两点：

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

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

# windows
Logo
亚马逊云科技技术品牌专区

更多推荐

open-code-review Codex 插件教程：对话式调用评审技能指南

本文是一份面向新手的 **open-code-review Codex 插件教程**，教你在 Codex 中通过对话式方式调用 open-code-review 的 AI 代码评审技能。open-code-review 是阿里巴巴开源的 AI 代码评审工具，采用"确定性流水线 + LLM Agent"混合架构，内置多语言评审规则（NPE、线程安全、XSS、SQL 注入等），可在 Codex 里用一

avatar 亚马逊云科技技术品牌专区

OBS Studio 完整指南：免费开源录屏与直播软件从零上手

想做一场像模像样的直播，或者把屏幕内容录成教程视频，但一想到商用软件的订阅费就有些犹豫？其实你不需要花一分钱。OBS Studio 是一款免费开源的直播与录屏软件，支持 Windows、macOS 和 Linux，采集、混音、编码、推流、录制，一条流水线全包了。## 先搞清楚 OBS Studio 是什么OBS Studio 是一个"场景化"的采集合成工具：你把摄像头、窗口、浏览器、图片、

avatar 亚马逊云科技技术品牌专区

如何用MediaCrawler爬取小红书抖音数据？7大平台爬虫从安装到实战完整指南

MediaCrawler 是一个支持小红书、抖音、快手、B站、微博、百度贴吧、知乎的开源自媒体数据采集工具。它能按关键词、按帖子、按创作者主页三种方式抓取笔记/视频内容、评论甚至二级评论，并把结果存成 JSON、CSV、Excel 或数据库。适合做市场调研、竞品监控、内容选题的运营人员，以及想要现成爬虫框架而不想从零写 JS 逆向的开发者。## 从一次"手动抄数据"说起想象这个场景：你负责

avatar 亚马逊云科技技术品牌专区