Claude Code 安装与百炼 Coding Plan 模型配置指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，支持命令行交互、代码生成、项目重构等功能。本文介绍如何在 macOS 和 Windows 上安装 Claude Code，并配置阿里云百炼 Coding Plan 的多模型服务。

一、Claude Code 安装

1.1 安装要求

Node.js v18.0 或更高版本
macOS/Linux 或 Windows（需 WSL 或 Git for Windows）

1.2 macOS/Linux 安装

方式一：NPM 全局安装

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

验证安装：

bash
claude --version

1.3 Windows 安装

Windows 需要先安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行：

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

详细教程参考 Claude Code 官方 Windows 安装教程。

1.4 使用 Qwen Code 引导安装

如果遇到环境配置问题，可以用 Qwen Code 帮助安装：

bash
# 启动 Qwen Code
qwen

# 输入指令
请帮我安装 Claude Code。
1. 前置条件：需要先安装 Node.js（v18.0 或更高版本）。
2. 若已安装 Node.js，执行命令：npm install -g @anthropic-ai/claude-code
3. 安装完成后执行 claude --version 验证安装是否成功。

# 退出 Qwen Code
/exit

二、百炼 Coding Plan 简介

阿里云百炼 Coding Plan 是面向 AI 编程场景的订阅制大模型服务，整合多家国产旗舰模型：

2.1 支持模型

模型	特点	适用场景
qwen3.5-plus	原生编程模型，效率突出	日常开发、Bug修复
kimi-k2.5	长上下文处理强	大文件解析、复杂项目
glm-5	逻辑推理优异	高难度编程、数据分析
MiniMax-M2.5	Agent场景优化	Excel处理、深度调研
qwen3-coder-plus	代码专用	专业编程任务
qwen3-coder-next	最新代码模型	前沿编程任务

2.2 定价与额度

Pro 版：200元/月，90,000次请求
周期限流：每5小时6,000次、每周45,000次
固定月费，无额外按量费用

2.3 订阅地址

👉 阿里云百炼 Coding Plan

三、配置 Claude Code 对接 Coding Plan

3.1 获取 API Key

登录阿里云百炼控制台
进入「订阅套餐」→「Coding Plan」
生成专属 API Key

⚠️ 注意：必须使用 Coding Plan 专属 API Key，通用百炼 Key 无法扣减套餐额度。

3.2 macOS/Linux 配置

步骤 1：创建配置目录

bash
mkdir -p ~/.claude

步骤 2：编辑配置文件

bash
nano ~/.claude/settings.json

写入以下内容（将 YOUR_API_KEY 替换为你的专属 API Key）：

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

步骤 3：设置 Onboarding 标志

bash
nano ~/.claude.json

写入：

json
{
  "hasCompletedOnboarding": true
}

⚠️ hasCompletedOnboarding 必须作为顶层字段，请勿嵌套于其他字段。此步骤可避免启动时报错：Unable to connect to Anthropic services。

步骤 4：重启终端

关闭当前终端，重新打开一个新终端即可生效。

3.3 Windows 配置

步骤 1：创建配置目录

CMD：

cmd
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

PowerShell：

powershell
mkdir -Force $HOME\.claude

步骤 2：打开配置文件

CMD：

cmd
notepad "%USERPROFILE%\.claude\settings.json"

PowerShell：

powershell
notepad $HOME\.claude\settings.json

步骤 3：编辑配置文件

写入以下内容（将 YOUR_API_KEY 替换为你的专属 API Key）：

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

步骤 4：设置 Onboarding 标志

编辑 C:\Users\您的用户名\.claude.json：

json
{
  "hasCompletedOnboarding": true
}

步骤 5：重启终端

关闭当前终端，重新打开一个新终端即可生效。

四、使用 Claude Code

4.1 启动

bash
# 进入项目目录
cd path/to/your_project

# 启动 Claude Code
claude

4.2 验证配置

在 Claude Code 中输入：


/status

确认模型、Base URL、API Key 是否配置正确。

五、模型切换

5.1 启动时指定模型

bash
claude --model qwen3-coder-next

5.2 会话期间切换


/model qwen3-coder-next

5.3 推荐使用场景

模型	适用场景
qwen3.5-plus	日常对话、通用任务
qwen3-coder-plus	专业代码生成
qwen3-coder-next	前沿编程任务
kimi-k2.5	长文档分析、大文件解析
glm-5	数学推理、算法设计

六、常用命令

命令	说明
`/init`	生成 CLAUDE.md 项目指令文件
`/status`	查看当前模型、API Key、Base URL 等配置
`/model <模型名>`	切换模型
`/clear`	清除对话历史
`/plan`	进入规划模式，只分析不修改代码
`/compact`	压缩对话历史，释放上下文空间
`/config`	打开配置菜单

七、IDE 插件支持

7.1 VS Code

在扩展市场搜索 Claude Code for VS Code 并安装
重启 VS Code
点击右上角图标开始对话
切换模型：输入 / → 选择 General config → 在 Selected Model 中选择模型

7.2 JetBrains 系列

支持 IntelliJ IDEA、PyCharm 等：

在扩展市场搜索 Claude Code 并安装
重启 IDE
点击右上角图标使用
通过 /model 命令切换模型

八、常见问题

Q1: 启动报错 "Unable to connect to Anthropic services"

确保 ~/.claude.json 文件中设置了：

json
{
  "hasCompletedOnboarding": true
}

Q2: 调用报错 401/403

确认使用 Coding Plan 专属 API Key
确认 Base URL 正确：https://coding.dashscope.aliyuncs.com/apps/anthropic
检查套餐是否在有效期内

Q3: 如何查看剩余额度

登录百炼控制台 → 订阅套餐 → 套餐用量

九、参考资料

本文更新于 2026-03-26，如有问题欢迎留言讨论。