【Claude Code】Mac安装Claude Code、通过阿里云百炼接入Claude Code

[1、Mac 电脑安装 Claude Code](#1、Mac 电脑安装 Claude Code)
- [1.1 下载Claude Code](#1.1 下载Claude Code)
- [1.2 配置 Claude Code（绕过 IP 限制并接入阿里云百炼）](#1.2 配置 Claude Code（绕过 IP 限制并接入阿里云百炼）)
- - [1.2.1 修改 ~/.claude.json 跳过连接错误](#1.2.1 修改 ~/.claude.json 跳过连接错误)
  - [1.2.2 修改 ~/.claude/settings.json 接入阿里云百炼](#1.2.2 修改 ~/.claude/settings.json 接入阿里云百炼)
  - [1.2.3 在阿里云百炼中申请 API-Key 并开通模型](#1.2.3 在阿里云百炼中申请 API-Key 并开通模型)

1、Mac 电脑安装 Claude Code

1.1 下载Claude Code

我的电脑是 MacBook Pro，其他 Mac 机型同样适用。

安裝或更新 Node.js（v18.0 或更高版本）。
在终端中执行下列命令，安裝 Claude Code。

bash 复制代码

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

运行以下命令验证安装，若有版本号码输出，则表示安装成功。

bash 复制代码

claude --version

以上命令安装失败的话，请参考：claude code官方安装文档

1.2 配置 Claude Code（绕过 IP 限制并接入阿里云百炼）

中国大陆直接使用 Claude Code 会因网络封锁而报错，你需要将后端指向阿里云百炼的兼容接口，从而跳过登录。

1.2.1 修改 ~/.claude.json 跳过连接错误

首次运行 claude，会提示无法连接到 anthropic服务。

bash 复制代码

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Please check your internet connection and network settings.

在你的用户主目录下编辑 ~/.claude.json。

bash 复制代码

vim ~/.claude.json

新增以下内容：

bash 复制代码

{
  "hasCompletedOnboarding": true
}

这一步可以避免 Claude Code 在启动时强制要求连接 Anthropic 官方服务。

1.2.2 修改 ~/.claude/settings.json 接入阿里云百炼

再次运行 claude，可以进入交互界面，但输入问题后会提示 Not logged in。

此时需要配置 API 地址和密钥。

编辑 ~/.claude/settings.json

bash 复制代码

vim ~/.claude/settings.json

填入以下内容（请替换为你自己的信息）：

bash 复制代码

{
  "hasCompletedOnboarding": true,
  "model": "你在阿里云百炼上申请的模型名称，比如qwen-plus",
  "env": {
    "ANTHROPIC_API_KEY": "你在阿里云百炼上申请的api_key",
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic"
  }
}

model 字段填写你在百炼中开通的模型别名（如 qwen-plus、qwen-turbo），建议使用不带日期后缀的稳定名称。

保存后重新启动 Claude Code，即可正常对话。

1.2.3 在阿里云百炼中申请 API-Key 并开通模型

1、访问阿里云百炼控制台：阿里云百炼文档地址

2、创建并保存好你的api_key：申请API Key的网址

3、确认模型已开启：阿里云百炼查看模型用量网址

进入「模型广场」或「模型用量」页面，查看你计划使用的模型（例如 qwen-plus）的状态是否为「已开启」。