ByteNoteByteNote
字

字节笔记本

2026年2月22日

Claude Code macOS 安装配置完全指南

#Claude Code
API中转
¥120
每日科技简报 · 每天一篇,快速了解科技圈大事

本文介绍如何在 macOS 系统上安装和配置 Claude Code，包括 Node.js 环境安装（Homebrew 和官网下载）、Claude Code 安装、环境变量配置以及其他 CLI 工具（Gemini CLI、Codex、Droid CLI）的配置方法。

macOS 安装教程

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

bash
# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载

  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS 版本
  3. 打开下载的 .pkg 文件
  4. 按照安装程序指引完成安装

macOS 注意事项

  • 如果遇到权限问题，可能需要使用 sudo
  • 首次运行可能需要在系统偏好设置中允许
  • 建议使用 Terminal 或 iTerm2

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

bash
node --version
npm --version

如果显示版本号，说明安装成功了！

2. 安装 Claude Code

打开 Terminal，运行以下命令：

bash
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

bash
claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3. 设置环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：临时设置（当前会话）

在 Terminal 中运行以下命令：

bash
export ANTHROPIC_BASE_URL="https://glm.bytenote.net/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

记得将 "你的API密钥" 替换为在 BBQ 管理后台 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

bash
# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="https://glm.bytenote.net/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://glm.bytenote.net/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：

配置文件位置：~/.claude/config.json

如果该文件不存在，请手动创建。

json
{
  "primaryApiKey": "crs"
}

4. 配置其他 CLI 工具

配置 Gemini CLI 环境变量

如果你使用 Gemini CLI，需要设置以下环境变量：

Terminal 设置方法：

bash
export GOOGLE_GEMINI_BASE_URL="https://glm.bytenote.net/gemini"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-2.5-pro"

永久设置方法：

添加到你的 shell 配置文件：

bash
# 对于 zsh (默认)
echo 'export GOOGLE_GEMINI_BASE_URL="https://glm.bytenote.net/gemini"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export GOOGLE_GEMINI_BASE_URL="https://glm.bytenote.net/gemini"' >> ~/.bash_profile
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bash_profile
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.bash_profile
source ~/.bash_profile

验证 Gemini CLI 环境变量

在 Terminal 中验证：

bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

配置 Codex 环境变量

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：

Codex 配置文件 (~/.codex/config.toml)：

toml
model_provider = "crs"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://glm.bytenote.net/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

在 ~/.codex/auth.json 文件中配置 API 密钥：

json
{
  "OPENAI_API_KEY": null
}

将 OPENAI_API_KEY 设置为 null，然后设置环境变量 CRS_OAI_KEY 为您的 API 密钥（格式如 cr_xxxxxxxxxx）。

环境变量设置方法：

bash
export CRS_OAI_KEY=cr_xxxxxxxxxx

Shell 配置文件（持久保存）：

bash
# 对于 zsh (默认)
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.bash_profile
source ~/.bash_profile

配置 Droid CLI

Droid CLI 使用 ~/.factory/config.json 保存自定义模型；你可以在 Finder 中按 ⌘ + Shift + G 并输入路径，或运行 open ~/.factory 快速打开配置目录。

配置文件示例：

json
{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [crs]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "https://glm.bytenote.net/droid/claude",
      "api_key": "你的API密钥",
      "provider": "anthropic",
      "max_tokens": 8192
    },
    {
      "model_display_name": "GPT5-Codex [crs]",
      "model": "gpt-5-codex",
      "base_url": "https://glm.bytenote.net/droid/openai",
      "api_key": "你的API密钥",
      "provider": "openai",
      "max_tokens": 16384
    }
  ]
}

在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池；确保服务地址可被本地访问。

5. 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code：

bash
claude

在特定项目中使用：

bash
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

macOS 常见问题解决

安装时提示权限错误

  • 使用 sudo 运行安装命令
  • 或者修改 npm 全局安装目录权限：
    bash
    sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

macOS 安全设置阻止运行

  • 前往「系统偏好设置」→「安全性与隐私」→「通用」
  • 点击「仍要打开」允许运行

环境变量不生效

  • 确认使用了正确的 shell 配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bash_profile）
  • 运行 source ~/.zshrc 或重启 Terminal

相关链接

Claude Code
上一篇

Claude Code Windows 安装配置完全指南

下一篇

Claude Code macOS 安装配置完全指南

分享: