Claude Code安装并接入阿里云百炼模型的完整教学实践整理

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code安装并接入阿里云百炼模型的完整教学”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

Claude Code 安装

在 IT 圈，Claude Code 早已如雷贯耳，作为一个软件开发者，如果还不知道它，多少有点落后了

安装很轻松

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

实际处理时，Windows PowerShell 可以按 Win 键，随后搜索它

打开之后是这个样子

跟 CMD 是不是很像？但它比 CMD 强大很多

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

我以 Win10 为例，借助 Windows PowerShell 来安装，不出意外的话会安装失败

理解这一步时，因为 Claude 公司（Anthropic）对中国区采取了严格封锁措施，所以用

irm https://claude.ai/install.ps1 | iex

理解这一步时，会安装失败。既然此路不通，那我们就换条路，用 npm 方式安装；安装 Claude Code 之前，我们需先安装另外两个工具

Git （仅 Windows 需，Mac / Linux 跳过）

实际处理时，Claude Code 原生是为 Linux / macOS 设计的，而 Windows 系统命令不同，所以需装 Git 完成命令的兼容转换；从Git 官网下载，安装的时候一直下一步就行。安装完成之后，我们可以在 cmd 中输入命令：

git -v

查看安装的 Git 版本

C:Users99791>git -v
git version 2.54.0.windows.1

Node

在这个场景下，因为 npm 依赖 Node，所以我们得安装 Node；从Node 官网下载，安装的时候一直下一步，安装完成之后，我们可以查看它们的版本

C:Users99791>node -v
v24.15.0

C:Users99791>npm -v
11.12.1

接下来安装 Claude Code 就轻松了，在 cmd 下执行命令

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

顺利的话，会输出如下所示信息

C:Users99791>npm install -g @anthropic-ai/claude-code

added 2 packages in 12s

没报错就说明安装成功了，我们看下 Claude Code 版本

C:Users99791>claude --version
2.1.139 (Claude Code)

若 npm 安装过程比较久甚至直接超时，我们可以先设置国内镜像

npm config set registry https://registry.npmmirror.com/

然后再用 npm 安装 Claude Code

实际处理时，安装好之后，接下来就是采用 Claude，直接在 cmd 下输入 claude，随后回车，我们会发现启动失败

在这个场景下，Claude 默认会用它自己的大模型，但它做了区域限制，中国区就被严格封锁了。所以我们需给 Claude 设置中国区兼容的大模型

阿里云百炼

理解这一步时，大模型都是要收费的，但很多提供了免费试用额度，比如阿里云百炼中的很多大模型

理解这一步时，看中我们要采用的大模型后，将右侧的 免费额度用完即停 开关开启，100万 token 一下就用完了，不开启的话，就会扣你账户里面的钱了；最轻松的方式，选 批量开启

然后 一键开启所有模型

登录阿里云之后呢，先设置好 API Key

实际处理时，随后我们就可以选其中某个模型（比如：qwen-math-turbo）设置到 Claude，

1.修改 settings.json

通常位于用户主目录的 .claude 目录下

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%.claudesettings.json

理解这一步时，若文件不存在，则直接新建一个，比如我的 C:Users99791.claudesetting.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_MODEL": "大模型名"
  }
}

这三个设置项需改成你们自己的

ANTHROPIC_BASE_URL

大模型兼容 Anthropic 规范的基本地址

阿里云百炼的地址是：（链接已移除）

其他模型提供商可以按上图类似的方式拿到

• DeepSeek：（链接已移除）
• 智谱AI（GLM）：（链接已移除）
• Kimi：（链接已移除）
• MiniMax：（链接已移除）
• Doubao：（链接已移除）
• Qianwen：（链接已移除）
• Hunyuan：（链接已移除）

ANTHROPIC_AUTH_TOKEN：从实现思路看，就是我们前面设置好的 API Key，作为 Claude 与大模型通信的鉴权凭证

ANTHROPIC_MODEL：设置我们前面选中的模型，示例中是：qwen-math-turbo

2.修改 .claude.json

落到代码里，通常位于用户主目录下，比如我的：C:Users99791.claude.json

在最后追加设置项：hasCompletedOnboarding，将其设置成 true，Claude Code 启动时会直接跳过新手引导（比如登录、网络校验等），进入正常工作模式。设置完后，.claude.json 设置项大致如下所示

{
  "firstStartTime": "2026-05-11T08:36:03.501Z",
  "opusProMigrationComplete": true,
  "sonnet1m45MigrationComplete": true,
  "seenNotifications": {},
  "migrationVersion": 13,
  "userID": "62fcb0ea393536eae5bcec7042e8defc4b3d838bb703b1130b78b378e3cdd70c",
  "changelogLastFetched": 1778635280930,
  "hasCompletedOnboarding": true
}

落到代码里，json 文件内容有格式限制，追加 hasCompletedOnboarding 的时候，要在上一个设置项的末尾添加一个英文逗号！！！

在这个场景下，我们新开 cmd 窗口，启动 Claude 不报错了，会让我们确认工作空间是否可信

落到代码里，我们选择 1，回车后让我们选择是否采用我们自定义的 API Key，毫无疑问选择 1. yes，回车后 Claude Code 启动成功

我们输入命令：/model，就可以看到我们设置的大模型（qwen-math-turbo）了

实际处理时，至此，设置算是完成了。我们可以和 Claude 对话了，不幸运的话，你们会和我一样，对话失败

结合项目来看，这是因为 qwen-math-turbo 同时未实现对 Anthropic 的兼容，兼容的模型只包含如下所示这些

我们换 deepseek-v4-pro 试试，只需将 Claude settings.json 中的 ANTHROPIC_MODEL 设置项值调整成 deepseek-v4-pro 即可。在 Claude 终端输入 exit 退出 Claude 后，再启动 Claude

理解这一步时，模型切换成功，可以和 Claude 正常对话了；对话的时候，尽量把背景描述清楚，对输出也要求更细致，如果我们泛泛而问，它自然也就泛泛而答了

实际处理时，token 消耗是很快的，一定要注意你们的 token 额度，如果是白嫖的话，一定要把 免费额度用完即停 开启，100万免费 token 分分钟就用完了

CC SWITCH

实际处理时，对于 Claude Code 的自定义模型设置，直接改 settings.json 是不是不够便于，特别是在不同的提供商来回切换时，格外不便捷。所以，切换工具应运而生，CC Switch 就是其中之一，直接下载最新版安装即可

安装完后启动，界面如下所示

实际处理时，第一个 Claude Official 是 Claude 模型，CC Switch 内置的，国内用不了，我们可以直接删掉。第二个 default，接下来的 https 地址看着眼熟吗，编辑下它就知道了，就是我们在 Claude settings.json 中设置的模型，CC Swith读取了而已

CC Switch 内置了很多主流模型供应商设置

我们设置这些内置的供应商时，只需设置API Key即可

若我们采用的是自定义，那么必配的项包括

• API Key
• 请求地址，也就是前面提到的 ANTHROPIC_BASE_URL
• 模型映射

其他的设置项保持默认即可

想采用哪个模型，直接启用他即可

实际处理时，切换很便于。当然，CC Switch 的功能远不止切换模型，详情可查看官方说明

实际处理时，当我们切换模型后，要退出 Claude 再重新启动，就可以看到生效的是切换后的模型了

总结

落到代码里，Claude Code 安装同时接入自定义模型，其实很轻松，耐心、细致点，都能搭建好。难的是如何用对、用好（laude CodeAI），另外就是 token 额度问题，如果公司能够帮我们买单，那是最好了，自费的话，可能会是一笔不小的开销

结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。