夜雨聆风我在一台普通电脑-家庭版Windows 11 机器上，完整走通了 Claude Code 的部署全链路，中间触发了 9 个阻断或阻塞级问题。我把每个坑都记了下来。
没接触过编程的小伙伴，可以把这篇文章当做攻略，扔给EasyClaw，让它给你来部署。
由于Claude Code只支持Linux或IOS系统，并且Claude Code 只认 Anthropic Messages 格式，而DeepSeek 只认 OpenAI 格式。所以整套部署方案的架构：
Claude Code（WSL/Ubuntu）→ LiteLLM 代理（localhost:4000）→ DeepSeek V4（deepseek-chat）
但为了让这三层跑起来，我遇到了三类问题：
1.网络问题（3个阻断级）：WSL 官方安装失败、Claude Code 安装脚本被地区限制、PyPI 直连超时。
2.环境问题（2个阻断级）：Node.js 版本冲突、Claude Code 不支持 DeepSeek 原生接入。
3.工程适配问题（4个）：WSL NAT 无法回连宿主机、PowerShell 与 bash 的转义冲突、LiteLLM 鉴权配置、模型 cost map 加载失败。
下面按时间线还原整个过程。每个踩坑点都标了严重度，你可以根据实际环境选择是否跳过某一步。
触发问题数：2 个（1 阻断 / 1 工作流阻塞）
Claude Code 官方不支持 Windows。Anthropic 推荐的方式是 WSL 2，我们照着来。但踩的第一个坑出人意料——Windows 自带的 inbox 版 WSL 无法完成在线安装。
执行 `wsl --install -d Ubuntu` 后，报错：「安全频道支持出错」。尝试了 `wsl --update --web-download`、`winget install`、Microsoft Store 在线安装，全部失败。你的 WSL 是 Windows 镜像自带的残缺版本，TLS 握手打不通微软服务器时，这些依赖在线通道的路径全都会断。
最终方案是离线导入。我们从 Ubuntu cloud-images 官方下载了 rootfs（325MB 的 `.tar.gz` 格式），用一条命令导入：
bash
wsl--importUbuntuC:\wsl\ubuntuubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz--version2
关键点：文件名必须精确匹配 `ubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz`，不能是 `.tar.xz`；目标目录 `C:\wsl\ubuntu` 需要事先创建。`--import` 是全离线操作，彻底绕开了 TLS 问题。
🔴 踩坑等级：阻断。 如果这条路也走不通，整个部署就卡在第一步。
触发问题数：1 个
进入 WSL 后的第一件事是装 Node.js——Claude Code 的运行时依赖。Ubuntu 22.04 apt 默认仓库提供的 Node.js 是 **v12**，Claude Code 要求 **v18+**。直接 `apt-get install nodejs` 会导致 Claude Code 安装失败，而且旧版 libnode-dev 包会与新版本冲突。
正确流程是先 purge 旧版再装新版：
```bash
apt-getpurge-ynodejslibnode-devlibnode72
curl-fsSLhttps://deb.nodesource.com/setup_20.x | bash-
apt-getinstall-ynodejs
```
装好后 `npm install -g @anthropic-ai/claude-code` 就能正常跑了。注意全局安装需要 root 权限，建议直接在 WSL root 用户下操作。
> 🔴 踩坑等级：阻断。Ubuntu 22.04 的默认 node 版本确实太旧了。
触发问题数：2 个（1 阻断 / 1 工程阻塞）
第一步是获取安装脚本。官方文档说 `curl -fsSL https://claude.ai/install.sh | bash`，但我们在国内执行这条命令时，返回的不是 Shell 脚本，而是 **「App unavailable in region」HTML 页面**。Anthropic 对中国地区做了访问限制。
退路是 npm 直接安装：`npm install -g @anthropic-ai/claude-code`，实测可行，版本 v2.1.175。
装好之后，更大的问题来了：Claude Code 怎么接入 DeepSeek？
它不是一个通用 LLM 客户端，而是一个 Anthropic 专有工具。它只认 Anthropic Messages API 格式，不认 OpenAI 兼容格式。你不能像改一个 curl 请求的 URL 那样让它去调 DeepSeek。即使你在 `settings.json` 里配置了 `ANTHROPIC_BASE_URL` 环境变量，也只是路由请求，不能改变模型供应商。
这是整个架构中最核心的决策点：需要一个 LLM Gateway 来做协议翻译。
🔴 踩坑等级：阻断（架构级）。 这个问题不解决，后面一切都无法推进。
触发问题数：4 个（1 阻断 / 1 重要 / 2 小问题）
经过对比，我们选用了 LiteLLM。它是 Anthropic 官方文档推荐的 LLM Gateway，原生支持 Anthropic Messages ↔ OpenAI 格式的双向翻译，社区活跃。
但 `pip3 install litellm[proxy]` 第一条命令就挂了——**PyPI 直连超时**。国内网络访问 pypi.org 极不稳定。解决方案简单直接：切到清华镜像源。
```bash
apt-getinstallpython3-pip
pip3install-ihttps://pypi.tuna.tsinghua.edu.cn/simplelitellm[proxy]
```
安装完成后，编写 LiteLLM 的核心配置文件 `~/litellm/config.yaml`：
```yaml
model_list:
- model_name: deepseek-v4
litellm_params:
model: deepseek/deepseek-chat
api_key: sk-your-deepseek-api-key
litellm_settings:
drop_params: true
general_settings:
master_key: your-proxy-key
```
然后更新 Claude Code 的 `~/.claude/settings.json`，让它指向本地代理：
```json
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:4000",
"ANTHROPIC_AUTH_TOKEN": "your-proxy-key"
}
}
```
启动 LiteLLM 后有两个小坑需要注意：一是 health check 默认需要 master_key 鉴权（不带 token 请求会返回 401），二是 LiteLLM 启动时会从 GitHub raw 拉取模型 cost map，国内环境大概率会超时，但不影响核心功能，会自动回退到本地缓存。
> 🔴 阻断：PyPI 直连失败 → 切清华源
> 🟡 重要：配置文件中两个 key 必须对应，一处写错链路就断
触发问题数：1 个
部署过程中我们还发现一个容易被忽略的问题：**WSL 2 的 NAT 网络模式下，WSL 内部无法通过 localhost 访问 Windows 宿主机的代理服务。**
如果你的 Windows 上跑着某个代理（比如 Clash），WSL 里的程序想通过这个代理联网，用 `localhost:port` 是连不上的。WSL 的网关 IP（通常 172.x）和宿主机 IP（192.168.x）处于不同网段，而且 WSL 的防火墙可能阻止 NAT 回连。
在我们的部署中，LiteLLM 和 Claude Code 都跑在 WSL 内部，DeepSeek API 通过 WSL 直连外网，所以没有受到这个限制。但如果你计划在 Windows 上跑代理、在 WSL 里通过代理连 Claude Code，需要额外处理网络互通问题。
🟡 重要：这个坑不影响本文方案，但可能影响其他变体部署。
所有组件就位后，验证流程如下：
1. 启动 LiteLLM 代理 → PID 确认、端口 4000 监听
2. Health check（带 token）→ `healthy_count=1` ✅
3. 直接 API 调用测试 → DeepSeek 返回「你好」✅
4.`claude -p` 代理模式对话 → 正常响应 ✅
我们把这个流程封装成了一个启动脚本 `~/litellm/proxy.sh`，支持 start/stop/restart/status 四个子命令。日常使用只需三步：
```bash
# 1. 进入 WSL
wsl-dUbuntu
# 2. 启动代理（一次就够了）
bash~/litellm/proxy.shstart
# 3. 开始用
claude# 交互模式
claude-p"帮我写一个 Python 排序函数"# 单次问答
```
我们把全部踩到的坑按严重度做了一个分级。你可以把它当成部署前的快速排雷清单：
| 问题 | 解决方案 | |
本文所有技术步骤基于 2026年6月12-13日在一台 Windows 11 (Build 22621) 个人电脑上的真实部署记录。环境配置可能与你的机器有差异，建议优先对照「问题总表」检查自己的阻断点再执行。
历史文章：
