Claude Code - macOS

本页介绍如何在 macOS 上安装 Claude Code，并将其接入 LuminaToken。

环境准备

开始前请确认：

• 系统为 macOS
• 已安装 Node.js 与 npm
• 可以在终端中执行 node -v 与 npm -v
• 已在 LuminaToken 控制台创建 API Key

如果你使用 zsh，后续持久化配置通常写入 ~/.zshrc。

安装 Claude Code

在终端执行：

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

安装完成后，可以先执行下面的命令确认 CLI 是否可用：

claude --version

如果你的命令名在当前版本中不同，请以安装后终端提示为准。

配置 LuminaToken 环境变量

在当前终端会话中执行：

export ANTHROPIC_BASE_URL=https://api.luminatoken.cc
export ANTHROPIC_AUTH_TOKEN=你的API_Key

说明：

• ANTHROPIC_BASE_URL 指向 LuminaToken 的统一网关地址。
• ANTHROPIC_AUTH_TOKEN 填写你在控制台复制的 API Key。

写入 ~/.zshrc 持久化

为了避免每次打开终端都重新设置，建议把环境变量写入 ~/.zshrc：

export ANTHROPIC_BASE_URL=https://api.luminatoken.cc
export ANTHROPIC_AUTH_TOKEN=你的API_Key

保存后执行：

source ~/.zshrc

验证配置

先检查环境变量是否存在：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期结果：

• 第一行输出 https://api.luminatoken.cc
• 第二行输出你的 Key 或其部分内容

再执行一次版本命令，确认 CLI 本身可用：

claude --version

如果你希望更进一步，可以在 Claude Code 中发起一个最简单的请求，验证链路是否已经能正常返回结果。

常见问题

提示找不到 claude

• 确认 npm install -g 是否成功。
• 确认全局 npm bin 目录已在 PATH 中。
• 重新打开终端后再试一次。

环境变量设置后不生效

• 确认你使用的是 zsh。
• 确认 source ~/.zshrc 已执行。
• 确认没有在别的配置文件中覆盖同名变量。

请求失败

优先检查三件事：

1. Key 是否复制完整。
2. Base URL 是否写成了 https://api.luminatoken.cc。
3. 账户是否有余额。

下一步

• 如果你还需要跨平台配置，可继续查看 Claude Code - Windows / Linux。
• 如果你想直接了解接口格式，请阅读 Anthropic 格式。