CQTAI

WSL 配置

Windows 用户可在 WSL（Windows Subsystem for Linux）里运行 Claude Code 等 AI 终端，体验与原生 Linux 一致。本文介绍在 WSL 中接入 CQT AI。

如果你已经在 Windows 原生终端配好了，可跳过本文。WSL 适合需要 Linux 环境的开发者。

前置条件

  • Windows 10/11。
  • 已申请 CQT AI 的 APIKey（在控制台「APIKey 管理」创建）。

第一步：安装 WSL

以管理员身份打开 PowerShell，运行：

wsl --install

安装完成后重启电脑，首次进入会提示创建 Linux 用户名和密码。

第二步：进入 WSL 并安装 Node.js

打开「Ubuntu」（或运行 wsl 进入），安装 Node.js 18+：

# 安装 nvm 后用它装 Node（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

# 验证
node -v

第三步：安装 Claude Code

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

第四步：配置指向 CQT AI

创建并编辑 Claude Code 配置文件：

mkdir -p ~/.claude
nano ~/.claude/settings.json

写入以下内容（把 APIKey 换成你自己的）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.cqtai.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

第五步：运行

claude

对话测试是否配置成功。

💡 WSL 与 Windows 共享网络。如果使用代理，请确保 WSL 内可访问 https://api.cqtai.com。

常见问题

  • wsl --install 报错：确认已开启「虚拟机平台」与「适用于 Linux 的 Windows 子系统」功能，并重启。
  • node 命令找不到：重开终端或 source ~/.bashrc 让 nvm 生效。
  • 401 认证失败：检查 ANTHROPIC_AUTH_TOKEN 是否填对、无多余空格。
  • 连接失败：确认 ANTHROPIC_BASE_URL 为 https://api.cqtai.com，WSL 内网络可达。