Claude Code 联合 阿里(百炼大模型) 安装

WSL2 install Claude Code and Ali(Qianwen)

Claude code install Qianwen Model
Abstract
本文主要介绍一下在WSL2上成功安装Claude Code并且使用阿里千问大模型运行的过程

1. 背景

如何在MacOS中安装claude code，已经介绍过了Claude的发展，以及Claude Code是什么和特点

2026年2月，Google 限制了通过第三方 OAuth 客户端 OpenClaw 访问 Gemini 模型的 AI Ultra 订阅者账号。此次限制没有任何预警或解释，直接切断了每月支付 249.99 美元的用户对 Gemini 2.5 Pro 的访问权限，部分用户甚至面临 Gmail、Workspace 等关联服务一同受限的风险。而就在两天前，Anthropic 刚刚更新了法律条款，明确禁止在包括 OpenClaw 在内的第三方工具中使用 OAuth 令牌。

Anthropic 率先修改了消费者服务条款，将自 2024 年 2 月以来一直含糊其辞的规定写得明明白白：Claude Free、Pro 和 Max 账号的 OAuth 令牌仅限在 Claude Code 和 Claude.ai 中使用。在任何其他地方使用，包括 OpenClaw，均属违规。

Note

OAuth 是一种开放标准的授权框架，常用于第三方应用在用户授权下访问其在其他服务上的资源（如微信登录、Google 登录等），而不需要用户提供账号密码。

  • OAuth 令牌 是在这个流程中由授权服务器颁发给客户端的一串字符串，代表了用户的授权许可。
  • 你用微信登录一个网站，该网站会通过 OAuth 流程获得一个 token，之后用这个 token 调用微信 API 获取你的昵称、头像等。

就是授权登录，现在封禁了意味着claude code只能走API的路线

这种时候，国内的Code Plan面向开发者或企业用户的一种API 使用套餐，开始发力了

  • 每月一定数量的 API 调用额度(不同级别的套餐代表着用量和调用程度；并且分不同的时间刷新)
  • 更高的速率限制（RPM/TPM）
  • 通过API来调用模型接口

2. 阿里云Code Plan

2.1 注册账户

阿里云（Alibaba Cloud）是阿里巴巴集团旗下的云计算及人工智能科技公司，成立于2009年，总部位于中国杭州。它是全球知名的云计算服务提供商之一，也是亚太地区市场份额第一的云服务商（根据 Gartner、IDC 等多家权威机构报告）

类别 代表产品 说明
基础云服务 ECS（云服务器）、VPC（虚拟私有云） 提供虚拟机、网络隔离等基础能力
数据库 PolarDB、AnalyticDB 高性能、兼容 MySQL/PostgreSQL 的云原生数据库
大模型与 AI 通义千问（Qwen）、通义万相、通义听悟 自研大模型系列，支持文本、图像、语音、代码生成
AI 开发平台 PAI（Platform of Artificial Intelligence） 一站式机器学习和大模型训练/部署平台
Serverless 函数计算 FC 无需管理服务器，按实际运行时间计费
边缘与 IoT Link IoT Edge 支持物联网设备接入与边缘计算

登录网页，进行注册，因为是阿里集团下的所以可以直接支付宝、淘宝，1688，钉钉等直接登录

zhuce

2.2 购买套餐

Lite版本(轻量)足够日常使用了，新用户首月7.9元。次月续费5折，性价比拉满了

aliyun paln code

支持 Qwen3.5-Plus、Qwen3-Max、Qwen3-Coder-Next、Qwen3-Coder-Plus、MiniMax M2.5、GLM-5、Kimi-k2.5、GLM-4.7

2.3 API复制

购买之后进入阿里云百炼大模型的后台服务，因为阿里云服务非常的多需要找到Code Plan控制台，模型服务后台网址[https://bailian.console.aliyun.com/cn-beijing/?spm=a2c4g.11186623.0.0.9b684c4dqbiaaQ&tab=model#/efm/coding_plan]

进入后台之后，选择订阅套餐

Aliyun API

  • 复制专属的API Key
Tip

Coding Plan 专属的 API Key 和 Base URL 与百炼按量计费的 API Key（sk-xxxxx）和Base URL（https://dashscope.aliyuncs.com/xxxxxx）不互通，请勿混用。

  • Base URL：根据 AI 工具支持的 API 协议，使用以下对应的 Base URL。

    • OpenAI 兼容协议：https://coding.dashscope.aliyuncs.com/v1

    • Anthropic 兼容协议：https://coding.dashscope.aliyuncs.com/apps/anthropic

3. 安装Claude Code

3.1 Node.js安装

Node.js的安装 按照之前的方法即可

因为是nvm安装命令是从github上安装，所以需要科学上网

简单来说就是进入Node.js官网，选择LTS版本，然后选择自己安装系统的版本和方式，复制命令到终端即可

  • nvm: Node Version Manager，用于管理Node.js版本的工具
  • npm: Node Package Manager，Node.js的包管理工具
# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 24

# Verify the Node.js version:
node -v # Should print "v24.14.0".

# Verify npm version:
npm -v # Should print "11.9.0".
# Download and install Chocolatey:
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

# Download and install Node.js:
choco install nodejs --version="24.14.0"

# Verify the Node.js version:
node -v # Should print "v24.14.0".

# Verify npm version:
npm -v # Should print "11.9.0".

3.2 Claude Code安装

在MacOS和linux中，比较容易直接在终端使用npm进行安装,Mac中使用brew也是非常方便的

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

在 Windows 上使用 Claude Code，需要安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令。

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

3.3 配置Claude Code

在 Claude Code 中接入百炼 Coding Plan，需要配置以下信息：

  • ANTHROPIC_BASE_URL：设置为 https://coding.dashscope.aliyuncs.com/apps/anthropic
  • ANTHROPIC_AUTH_TOKEN：设置为Coding Plan专属 API Key
  • ANTHROPIC_MODEL：设置为 Coding Plan 支持的模型
Tip

推荐模型：qwen3.5-plus（支持图片理解）、kimi-k2.5（支持图片理解）、glm-5、MiniMax-M2.5

更多模型：qwen3-max-2026-01-23、qwen3-coder-next、qwen3-coder-plus、glm-4.7

不同的操作系统需要不同的配方方法，这个是需要注意的地方

3.3.1. MacOS/Linux

  1. 创建并打开配置文件~/.claude/settings.json

~是在主目录下，正常安装下会存在.claude文件夹，如果目录不存在，需要自行创建一个mkdir -p ~/.claude

# 修改，如果setting.json不存在会自行创建
nano ~/.claude/settings.json
  1. 编辑配置文件。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

保存配置文件，重新打开一个终端即可生效。

  1. 为了避免启动Claude Code时报错：Unable to connect to Anthropic services,需要增加一个限制文件~/.claude.json,文件中，找到hasCompletedOnboarding,常规为false，修改即可
{
  "hasCompletedOnboarding": true
}

3.3.2 Windows配置

在Windows中配置需要另一种配置方式

  1. 在 Windows 中，可以通过 CMD 或 PowerShell 将Coding Plan的 Base URL 和 API Key 设置为环境变量

第一步：在Powershell中输入下面的命令，记得修改Key，设置环境变量

# 用您的Coding Plan API Key 替换 YOUR_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://coding.dashscope.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "qwen3.5-plus", [EnvironmentVariableTarget]::User)

第二步，打开一个新的PowerShell窗口输入下面的命令，进行验证和检查

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
  1. 编辑或新增 C:%USERNAME%.claude.json 文件，将hasCompletedOnboarding 字段的值设置为 true，并保存文件。

按Win+R键，输入notepad %USERPROFILE%\.claude.json，回车即可打开,使用记事本直接编辑

{
  "hasCompletedOnboarding": true
}
  1. 根据测试，windows中需要设置setting,json文件，否则无法正常启动国产大模型，同样按照MacOS/Linux的模式操作即可
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.5-plus"
  }
}
  1. 重新打开一个终端即可生效。

4. Claude Code使用

  1. 打开终端，并进入项目所在的目录。运行以下命令启动程序 Claude Code：
cd project_directory

claude

  1. 启动后，需要授权Claude Code执行文件

  2. 输入/status确认模型、Base URL、API Key 是否配置正确。

status

4.1 切换模型

  1. 启动 Claude Code 时切换：在终端执行claude –model <模型名称>指定模型并启动 Claude Code，例如claude –model qwen3-coder-next。

  2. 会话期间：在对话框输入/model <模型名称>命令切换模型，例如/model qwen3-coder-next