Claude Code 安装教程（macOS/Linux）

一、方案简介

在 macOS / Linux 上安装 Claude Code 非常简单。我们将使用 官方原版 npm 包，仅通过环境变量将 API 地址指向 APIBox，从而实现国内无缝直连，价格仅为官方的 1/7。

二、安装步骤

1. 打开终端

• macOS：按 Cmd + Space 搜索 “Terminal”，或在「应用程序 > 实用工具」中打开。
• Linux：打开你的默认终端模拟器。

2. 运行环境检查脚本

自动检测你的系统是否已正确安装 Node.js 和 npm。

curl -fsSL https://api.17nas.com/env_deploy/env-install.sh | bash

3. 卸载旧版本（可选）

如果你之前尝试安装过其他版本的 Claude Code，请先卸载以避免冲突。如果是全新安装，可跳过此步。

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

4. 安装 Claude Code

通过官方 npm 源安装最新版本的 Claude Code。

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

5. 获取并配置 API 密钥

前往 APIBox 控制台 获取你的 API Key。

在终端中执行以下命令写入环境变量（以 zsh 为例）：

echo 'export ANTHROPIC_BASE_URL="https://api.apibox.cc/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的_APIBox_Key"' >> ~/.zshrc
source ~/.zshrc

注意：必须是 ANTHROPIC_AUTH_TOKEN，千万不要写成 API_KEY，否则会弹起网页登录。

6. 验证安装

在终端输入并运行：

claude

如果顺利进入交互界面，且没有任何网页登录弹窗，说明配置成功！

三、常见问题排查

❌ 启动后弹出网页登录

原因： 环境变量名称写错了。 解决： 确认你写的是 ANTHROPIC_AUTH_TOKEN，修改后记得 source 重新加载配置并重启终端。

❌ 报错：cannot be used with root/sudo

原因： 服务器默认以 root 身份运行，Claude Code 拦截了高权限运行。 解决： 执行以下命令即可：

echo 'export CLAUDE_CODE_BUBBLEWRAP=1' >> ~/.bashrc
source ~/.bashrc

❌ 突然崩溃退出 / H.startsWith 报错

原因： 可能是版本 bug 或本地存在旧版本缓存冲突。 解决：

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