macOS：Codex 终端版

本页以 macOS 默认的 Zsh 为例，并复用与 Windows 完全一致的 Codex Provider 配置。

在 macOS 上使用 Codex 终端版

Codex 通过自定义 Provider 调用悠然 AI 的 Responses API，并从用户环境变量读取个人 API Key。

确认适用方式
适合希望在终端中使用 Codex 处理本地代码，同时通过悠然 AI 管理模型额度的用户。
安装 Codex
打开终端，运行 OpenAI 官方独立安装器。
Shell
```
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
查看 Codex 官方仓库
验证安装
终端
```
codex --version
```
创建悠然 AI API Key
为当前设备创建独立 Key，后续通过 YOURAN_API_KEY 环境变量提供给 Codex。
打开访问密钥页面
查询可用模型
从实时返回的 data[].id 中选择模型 ID，不要照抄过期示例。
终端
```
curl -sS https://youran-ai.du-fu.com/api/models \\
  -H "Authorization: Bearer <YOURAN_API_KEY>"
```

保存 API Key 并打开配置文件

先保存用户级环境变量，再打开 ~/.codex/config.toml。

cat >> ~/.zshrc <<'EOF'
export YOURAN_API_KEY="<YOURAN_API_KEY>"
EOF

source ~/.zshrc
mkdir -p ~/.codex
${EDITOR:-nano} ~/.codex/config.toml

写入 Provider 配置
Provider TOML 与 Windows 完全一致，不再重复展示。
前往 Windows 的 Provider 配置
发起第一次请求
终端
```
codex "请只回复：连接成功"
```
Codex 会通过 youran Provider 调用 https://youran-ai.du-fu.com/api/responses。
遇到问题
确认配置位于用户级 ~/.codex/config.toml，并检查 YOURAN_API_KEY 在当前终端中可见。
前往故障排查