macOS 快速接入

适用于 Apple 芯片（M1/M2/M3/M4）和 Intel Mac。从零开始到第一次成功调用 AI，按顺序完成以下步骤。

先确认你的 Mac 芯片

点击左上角 → 关于本机：

看到什么	芯片类型	安装包选
Apple M1 / M2 / M3 / M4	Apple 芯片	arm64
Intel Core i5 / i7 / i9	Intel	x64

后面安装 Node.js 等软件时，需要选对应架构的安装包。

整体流程

和 Windows 一样，分为两个阶段：

第一阶段：在 小蓝中转站控制台准备好三样东西（不需要装任何软件）

1. 注册账号
2. 充值余额（¥10 即可）
3. 创建 API 密钥

第二阶段：选一个工具，把三样东西填进去

我想做什么	用什么工具	难度	需要先装什么
先确认接口能不能用	Cherry Studio	最简单	什么都不用装，下载客户端即可
在项目里直接改代码	Claude Code	中等	命令行工具 + Git
习惯 OpenAI 风格 CLI	Codex	中等	Git + Node.js

第一次用 小蓝中转站？

推荐先走 Cherry Studio 路径。不需要装命令行工具，下载一个桌面客户端就能测试。确认接口通了之后，再去配 Claude Code 或 Codex。

第一阶段：在 小蓝中转站 准备三样东西

1. 注册账号

打开 小蓝中转站 官网，点击右上角 注册。

填写用户名和密码，勾选人机验证，点击 创建账户。注册成功后登录。

详细步骤见 注册账号。

2. 充值 ¥10

登录后点击左侧导航栏 钱包，选 ¥10，用支付宝或微信完成支付。

第一次只需要 ¥10 跑通流程。详见 充值。

3. 创建 API 密钥

点击侧边栏 API 密钥 → 左上角 创建 API 密钥：

• 名称：填 Mac-Claude 或 Mac-Codex
• 分组：保持 auto
• 额度：先开 无限配额

点击 保存修改 后，新建的 Key 会出现在列表里（不会弹窗）。把鼠标移到 API 密钥 那一列，点出现的复制按钮，立即复制完整 Key（以 sk- 开头）。完整 Key 只能复制这一次，之后列表只显示前后几位，所以请马上保存好。

详见 创建专属 Key。

4. 复制模型名

点击顶部导航 模型广场，点击模型名即可复制：

不要自己编模型名，以这里显示的为准。

到这里你已经准备好了：

项目	你应该有什么	示例
账号	已注册并登录	✅
余额	≥ ¥10	✅
API Key	以 sk- 开头	sk-xxxxxxxxxxxxxx
模型名	从模型广场复制	claude-haiku-4-5-20251001

第二阶段：选一个工具开始

路径 A：Cherry Studio（最快验证）

不需要装命令行工具。从 Cherry Studio 官网 下载安装后，按 Cherry Studio 接入指南 配置。

路径 B：Claude Code（终端改代码）

需要先安装环境。按顺序完成：

1. → macOS 环境准备（命令行工具 + Homebrew + Git）
2. → macOS 接入 Claude Code

路径 C：Codex（OpenAI 风格 CLI）

需要先安装环境。按顺序完成：

1. → macOS 环境准备（命令行工具 + Node.js）
2. → macOS 接入 Codex

故障速查

现象	先查什么	怎么处理
xcode-select 弹窗提示安装	命令行工具未装	点击弹窗中的「安装」，等完成
command not found: brew	Homebrew 未装或 PATH 缺失	检查 PATH 是否包含 /opt/homebrew/bin
node / npm 命令不存在	Node.js 未装	重装 Node.js 后关闭终端重新打开
npm 权限错误	安装方式问题	用 Homebrew 装 Node.js（brew install node），避免 sudo
.zshrc 改了但不生效	终端未重载	source ~/.zshrc 或关闭终端重新打开
macOS 拦截应用打开	安全策略	系统设置 → 隐私与安全性 → 允许打开
提示 Key 无效	Key 状态	回控制台检查 Key 是否启用、余额是否充足
提示模型不存在	模型名	回模型广场重新复制完整模型名
连不上、一直转圈	Base URL	Claude Code/Gemini CLI 不加 /v1；Codex 必须加 /v1

遇到这些没解决的问题，带着完整报错截图去 排障手册。