Claude Code + WSL 从零配置教程（接入 Qwen / 国产模型）

适用系统：Windows 10/11
最后更新：2026年3月

---

第一步：安装 WSL2

打开 PowerShell（管理员），执行：

wsl --install

安装完成后重启电脑。重启后 Ubuntu 会自动弹出，按提示设置用户名和密码。

如果已有旧的 WSL，可先清理：

wsl --list --verbose        # 查看已有发行版
wsl --unregister Ubuntu     # 删除指定发行版
wsl --shutdown              # 关闭所有实例

然后重新执行 wsl --install。

---

第二步：安装 Node.js（v18+）

打开 Ubuntu 终端，执行：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装 Node.js v22
nvm install 22
nvm use 22

# 验证
node --version   # 应显示 v22.x.x
npm --version

---

第三步：安装 Claude Code

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

# 验证安装
claude --version

---

第四步：配置接入信息（以 Qwen / 百炼 Coding Plan 为例）

创建配置目录

mkdir -p ~/.claude

编辑 settings.json

nano ~/.claude/settings.json

粘贴以下内容，将 YOUR_API_KEY 替换为你的专属 API Key：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

保存：Ctrl+O → 回车 → Ctrl+X

---

第五步：跳过 Onboarding 检查

nano ~/.claude.json

确认文件中存在以下顶层字段（文件已存在则检查是否有该字段，没有则添加）：

{
  "hasCompletedOnboarding": true
}

⚠️ hasCompletedOnboarding 必须是顶层字段，不能嵌套在其他字段内部。
缺少此字段会导致启动时报错：Unable to connect to Anthropic services。

保存退出。

---

第六步：启动 Claude Code

# 在任意目录启动（测试阶段直接在主目录即可）
cd ~
claude

启动后输入以下命令验证配置：

/status

正常应显示：

字段	内容
Model	qwen3.5-plus
Anthropic base URL	https://coding.dashscope.aliyuncs.com/apps/anthropic
Auth token	ANTHROPIC_AUTH_TOKEN

配置无误即可开始使用 ✅

---

模型切换教程

方式一：会话中临时切换（立即生效）

在 Claude Code 对话框中输入：

/model 模型名称

示例：

/model qwen3-coder-next
/model glm-5

方式二：永久修改默认模型

编辑配置文件：

nano ~/.claude/settings.json

修改 ANTHROPIC_MODEL 字段：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "glm-5"
    }
}

保存后重启 Claude Code 生效。

方式三：启动时指定模型

claude --model glm-5

---

常用命令速查

命令	说明
/status	查看当前模型、API Key、Base URL 配置
/model <模型名>	切换模型
/init	在项目目录生成 CLAUDE.md 项目配置文件
/clear	清除对话历史，开始新对话
/plan	进入规划模式，只讨论方案不修改代码
/compact	压缩对话历史，释放上下文空间
/config	打开配置菜单（语言、主题等）

---

常见问题

Q：启动报错 Unable to connect to Anthropic services
A：检查 ~/.claude.json 中是否有 "hasCompletedOnboarding": true，且为顶层字段。

Q：/status 显示的 Auth token 不对
A：重新编辑 ~/.claude/settings.json，确认 API Key 填写正确，保存后重开终端再启动。

Q：模型名填错导致无法使用
A：前往阿里云百炼 Coding Plan 控制台查看支持的完整模型列表，复制准确的模型名称填入。

Q：不知道项目目录怎么办
A：直接 cd ~ 在主目录启动即可，项目目录只影响 Claude 能读取到哪些文件。