Claude Code - macOS 系统安装教程
前置准备
在开始之前，请确保：
- 已安装 Node.js 18 或更高版本
- 如果尚未安装，请查看 Node.js 安装教程
- 已在 https://ai.gaoxiao888.com 注册账号并获取 API Key
第一步：安装 Claude Code
打开终端（Terminal），执行以下命令：
bash
npm install -g @anthropic-ai/claude-code安装完成后，验证安装：
bash
claude --version第二步：配置环境变量
macOS 系统有三种配置方式，推荐使用方法 1。
方法 1：配置 settings.json（推荐）
- 创建或编辑
~/.claude/settings.json文件：
bash
mkdir -p ~/.claude
nano ~/.claude/settings.json- 输入以下内容：
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "替换为您的API Key",
"ANTHROPIC_BASE_URL": "https://ai.gaoxiao888.com/claude",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}- 按
Ctrl + O保存，按Ctrl + X退出
注意：
- 将
替换为您的API Key改为你在官网生成的实际 API Key - 其他渠道的 base URL 在生成 Key 的页面获取
方法 2：临时设置（仅当前终端有效）
在终端中执行：
bash
export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"
export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"方法 3：永久设置
根据你使用的 shell 类型选择：
如果使用 zsh（macOS 默认）：
bash
echo 'export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.zshrc
source ~/.zshrc如果使用 bash：
bash
echo 'export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bash_profile
source ~/.bash_profile第三步：验证配置
在终端中执行：
bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN如果显示正确的值，说明配置成功。
第四步：启动 Claude Code
在终端中执行：
bash
claude首次启动会进入交互模式，你可以开始与 Claude Code 对话了！
常见问题
1. 提示找不到 claude 命令
确保 Node.js 的全局包路径已添加到系统 PATH 中：
bash
echo $PATH2. 401 认证错误
检查 API Key 是否正确配置，确保没有多余的空格或引号。
3. 权限问题
如果遇到权限错误，可能需要使用 sudo：
bash
sudo npm install -g @anthropic-ai/claude-code