Claude Code 安装配置指南（macOS + OneHub 中转）

适用环境：macOS + bash + OneHub API 中转

步骤一：安装 Claude Code

# 官方安装命令（或按实际安装方式）
curl -fsSL https://claude.ai/install.sh | bash

安装完成后会提示

⚠ Setup notes: • Native installation exists but ~/.local/bin is not in your PATH. Run:

echo ‘export PATH=“$HOME/.local/bin:$PATH”’ >> ~/.bashrc && source ~/.bashrc

✅ Installation complete!

步骤二：修复 PATH 环境变量

有时候安装完成后，运行时候会提示-bash: claude: command not found，可能是环境变量问题，用下面的方式补充：

macOS 的 bash 启动时读取 ~/.bash_profile，而非 ~/.bashrc，需手动将安装目录加入 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

验证是否成功：

which claude
# 预期输出：/Users/你的用户名/.local/bin/claude

⚠️ 注意：不能用 sudo echo ... >> file 写文件，因为 >> 重定向由 shell 执行，没有 sudo 权限。 如遇到权限问题，改用：

sudo tee -a ~/.bash_profile <<< 'export PATH="$HOME/.local/bin:$PATH"'

步骤三：创建 API 配置文件

这里的key就是申请后在详情里面的key，实际是OneHub的Key。

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "你的OneHub Key",
    "ANTHROPIC_BASE_URL": "https://onehub.tap4fun.com/claude",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
EOF

⚠️ 关键点：OneHub 中转 key 必须使用 ANTHROPIC_API_KEY 字段名， 使用 ANTHROPIC_AUTH_TOKEN 会报 401 无效令牌错误。

步骤四：跳过 Onboarding

这里也直接在终端复制。

cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

步骤五：启动验证

完成好配置之后令其生效并启动，就可以使用了。使用前先进入你的代码文件目录，再启动claude。

source ~/.bash_profile && claude

正常启动后即可使用。

常见问题排查

问题 原因 解决方案
claude: command not found ~/.local/bin 不在 PATH 中 执行步骤二，写入 ~/.bash_profile
Permission denied 写入失败 sudo echo >> file 的重定向无权限 改用 sudo tee -a 或 sudo chown $(whoami) 文件路径
401 无效的令牌 字段名错误或 Key 无效 将字段名改为 ANTHROPIC_API_KEY，或去 OneHub 后台重新生成 Key
连接超时/重试 网络问题或 BASE_URL 配置错误 检查 ANTHROPIC_BASE_URL 是否正确

配置文件位置速查

文件 作用
~/.claude/settings.json API Key、Base URL、超时等环境变量配置
~/.claude.json 用户状态，设置 hasCompletedOnboarding: true 跳过引导
~/.bash_profile bash 环境变量，PATH 配置写在这里
.claude/settings.local.json 项目级配置（放在项目目录下）

← 返回 AI 编程