LvHeng

Appearance

Windows 畅玩 Claude Code

发布于 2025-09-04

无需海外账号，用阿里大模型 API 实现 Claude Code 的完美替代方案

背景 ​

由于 Anthropic 官方限制了中国区用户访问，即使注册了账号也无法正常使用 Claude Code。今天分享的技术方案，通过 Claude Code Router路由工具 + 阿里通义千问API，可以让国内的 Windows 用户也能无缝使用 Claude Code。

环境准备（WSL2中的Linux环境） ​

由于 Claude Code 仅支持 Linux 平台，我们需要在 Windows 中启用 WSL2，安装教程可以参考：如何使用 WSL 在 Windows 上安装 Linux

安装步骤 ​

基础环境配置 ​

为了避免在 WSL2 中安装时的 Claude Code is not supported on Windows 错误，需要重新安装 Node.js 和 npm，如下：

bash
sudo apt update && sudo apt upgrade -y
sudo apt install nodejs npm -y  # 必须重新安装 Node.js 环境

安装 Claude Code Router ​

bash
# 安装 Claude Code 本体
sudo npm install -g @anthropic-ai/claude-code

# 安装 Claude Code Router
sudo npm install -g @musistudio/claude-code-router

配置大模型 API 接入 ​

配置文件路径 ​

~/.claude-code-router/config.json
注：使用sudo安装，路径为/root/.claude-code-router/config.json

推荐配置（阿里通义千问示例） ​

json
{
  "log": false,
  "OPENAI_API_KEY": "你的 API 密钥",
  "OPENAI_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "OPENAI_MODEL": "qwen-plus",
  "Providers": [
    {
      "name": "qwen",
      "api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "api_key": "你的 API 密钥",
      "models": ["qwen-max", "qwen-turbo", "qwen-plus"]
    }
  ],
  "Router": {
    "background": "qwen,qwen-plus",      // 日常任务
    "think": "qwen,qwen-max",            // 复杂推理
    "longContext": "qwen,qwen-max"       // 长文本处理
  }
}

配置项说明 ​

  1. 全局 OpenAI 兼容配置
    • OPENAI_API_KEY: 用于访问 OpenAI 兼容 API 的密钥（这里是阿里 DashScope 的密钥）
    • OPENAI_BASE_URL: 基础 API 地址（已指向阿里 DashScope 的兼容模式端点）
    • OPENAI_MODEL: 默认使用的模型（已设置为阿里的 qwen-plus）
  2. Providers (模型提供商列表) 每个提供商包含：
    • name: 提供商名称（自定义标识）
    • api_base_url: 该提供商的 API 地址
    • api_key: 访问该提供商的 API 密钥
    • models: 该提供商下可用的模型列表
  3. Router (路由规则) 定义不同任务类型使用的模型：
    • background: 后台/常规任务使用的模型（格式：提供商名,模型名）
    • think: 复杂推理任务使用的模型
    • longContext: 长上下文处理任务使用的模型

关于阿里模型 ​

以下是阿里模型常用

模型名称适用场景性能特点
qwen-turbo日常代码补全响应最快，成本最低
qwen-plus综合任务（推荐默认）平衡精度与速度
qwen-max复杂算法/长上下文最强能力，支持128K上下文

运行 Claude Code ​

bash
ccr code  # 通过路由启动 Claude Code

启动后可在终端直接使用代码补全功能，体验与原版 Claude 基本一致~

常见故障排除 ​

权限问题 ​

由于 npm 全局包默认安装在 /usr/local/lib/node_modules/ 或 /usr/lib/node_modules/，普通用户可能无权访问。

需要修改 npm 全局包权限，让所有用户均可访问 root 安装的全局包，如下：

bash
# 修复 root 安装的全局包权限
sudo chmod -R 755 /usr/local/lib/node_modules/
sudo chmod 755 /usr/local/bin/

# 备用路径修复（适用于不同安装位置）
sudo chmod -R 755 /usr/lib/node_modules/

Claude Code Router 原理 ​

Claude Code Router 的基本原理：利用环境变量覆盖请求的 BaseURL 和 apiKey，并通过自定义服务将 OpenAI API 转换为 Anthropic API 格式。

7月18日更 ​

最近 K2 模型更新后，可以直接使用 K2，完全兼容 Anthropic API 格式。

相关链接 ​