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

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

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

1、Mac 电脑安装 Claude Code

1.1 下载Claude Code

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

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

npminstall-g@anthropic-ai/claude-code

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

claude--version

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

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

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

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

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

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。

vim~/.claude.json

新增以下内容：

{"hasCompletedOnboarding":true}

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

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

再次运行 claude，可以进入交互界面，但输入问题后会提示 Not logged in。
此时需要配置 API 地址和密钥。

编辑 ~/.claude/settings.json

vim~/.claude/settings.json

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

{"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）的状态是否为「已开启」。