macOS 接入 Claude Code

前置条件

开始之前，确保你已经完成：

1. ✅ 环境准备（命令行工具 + Git）
2. ✅ 小蓝中转站 账号已注册并充值
3. ✅ 已创建 API 密钥（以 sk- 开头的字符串）
4. ✅ 已从模型广场复制模型名

还没做？先回 macOS 快速接入 的第一阶段。

第 1 步：安装 Claude Code

打开终端，选一种方式安装：

方式一：官方脚本（推荐，不需要 Node.js）

curl -fsSL https://claude.ai/install.sh | bash

方式二：Homebrew

brew install --cask claude-code

方式三：npm（需要已安装 Node.js）

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

使用 sudo 时会提示输入密码，密码不会显示任何字符，直接输完按回车。

安装完成后验证：

claude --version

应该输出版本号。如果提示命令不存在，关闭终端重新打开再试。

第 2 步：配置 小蓝中转站 网关

Claude Code 需要知道三样东西：地址、Key、是否开启模型发现。

执行以下三条命令（把 sk-你的专属Key 替换成你在控制台创建的真实 Key）：

echo 'export ANTHROPIC_BASE_URL="https://xiaolan.ainb.plus"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的专属Key"' >> ~/.zshrc
echo 'export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"' >> ~/.zshrc
source ~/.zshrc

每条命令的含义：

变量	含义	注意
ANTHROPIC_BASE_URL	小蓝中转站 网关地址	只能写 https://xiaolan.ainb.plus，不要加 /v1
ANTHROPIC_AUTH_TOKEN	你的 API Key	以 sk- 开头，从控制台复制
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY	启动时自动发现可用模型	设为 1 开启

最常见的错误

Base URL 不要写成 https://xiaolan.ainb.plus/v1。Claude Code 会自己在后面拼接路径，你多写一个 /v1 会导致 404 错误。

用 Bash 而不是 Zsh？

如果你的终端用的是 Bash，把上面的 ~/.zshrc 全部换成 ~/.bashrc。不确定用的是哪个？执行 echo $SHELL 看输出。

验证环境变量是否生效：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

应该分别输出 https://xiaolan.ainb.plus 和你的 Key。如果输出为空，执行 source ~/.zshrc 或关闭终端重新打开。

第 3 步：固定默认模型（可选）

echo 'export ANTHROPIC_MODEL="从模型广场复制的模型名"' >> ~/.zshrc
source ~/.zshrc

也可以不设置，启动后用 /model 命令手动选择。

第 4 步：测试

创建一个测试目录，启动 Claude Code：

mkdir -p ~/xiaolan-claude-test
cd ~/xiaolan-claude-test
claude

Claude Code 启动后，输入一句话（比如「你好」）。如果能收到回复，说明配置成功。

如果弹出了官方登录界面，说明环境变量没有被正确读取。关闭 Claude Code，回到第 2 步重新检查。

配置成功后，你就可以在真实项目目录里使用 Claude Code 了：

cd 你的项目目录
claude

常见问题

现象	可能原因	怎么处理
弹出官方登录、连不上	环境变量没写入或没生效	重新执行第 2 步，用 echo $ANTHROPIC_BASE_URL 验证
报 404 错误	Base URL 多写了 /v1	编辑 ~/.zshrc 把 URL 改成 https://xiaolan.ainb.plus（不带 /v1）
启动后看不到模型列表	模型发现没开	确认 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 为 1
Key 无效 / 鉴权失败	Key 被停用或余额不足	回控制台检查 Key 状态和余额
模型不存在	模型名写错了	回模型广场重新复制完整模型名
claude 命令不存在	安装没成功	重新安装后关闭终端重开
sudo 密码输不进去	macOS 正常行为	密码不显示任何字符，直接输完按回车

遇到以上方法无法解决的问题，去 排障手册 按层级排查。