🍎 Mac OS 用户使用教程

Mac 用户按这篇操作。核心是安装 Codex CLI、写入 config.toml、设置 OPENAI_API_KEY。

1. 打开 Terminal

从 Launchpad 或 Spotlight 打开 Terminal。

2. 检查 Node.js 和 npm

node -v
npm -v

能看到版本号后，安装 Codex CLI：

npm install -g @openai/codex
codex --version

3. 写入配置文件

Mac 配置文件位置：

~/.codex/config.toml

model_provider = "shiyu"
model = "gpt-5.3-codex"
review_model = "gpt-5.3-codex"
model_reasoning_effort = "high"

[model_providers.shiyu]
name = "像素群岛"
base_url = "https://api.shiyutv.cn/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

4. 设置 API Key

当前 Terminal 窗口临时生效：

export OPENAI_API_KEY="【你的 API Key】"

如果要长期生效，可以写入自己的 shell 配置文件。截图请只展示变量名和打码 Key。

5. 测试

codex

进入后发送：

你好，请回复一句话确认 Codex CLI 已经接入成功。

排查清单

• base_url 是否是 https://api.shiyutv.cn/v1。
• OPENAI_API_KEY 是否在当前 Terminal 生效。
• 模型名称是否在后台可用。
• 改完配置后是否重启终端。
• 账号是否还有余额。