Mac 安装 Codex
在 macOS 上配置 Codex 桌面客户端或 CLI，接入本站 API Key。
选择使用方式
- 首次使用：从本步骤开始。
- 已安装桌面端或能运行 codex：从第 3 步开始。
- 像普通软件一样安装和打开。
- 无需 Node.js、npm 或 CLI。
在终端运行 codex 使用。
- 已安装 CLI：脚本直接写入配置。
- 尚未安装：按下一步补齐环境。
安装客户端
- 根据你的系统下载并安装 Codex 桌面客户端。
- 已安装可跳过此步。
打开命令窗口，检查 CLI 是否已安装。
- 按 Command + 空格，输入 Terminal，然后按回车。
codex- 能正常启动：继续下一步。
- 找不到命令：先安装 Node.js LTS，再安装 CLI。
安装 Node.js 后重新打开命令窗口，执行：
npm install -g @openai/codex准备 API Key
从交付信息复制完整 API Key，不带前后空格。
已有自定义配置时，先备份 config.toml 和 auth.json。
运行配置命令
打开终端：Command + 空格，搜索 Terminal。
将 粘贴你的APIKey 替换为真实 Key 后执行。
curl -fsSL https://console.novamodelhub.com/install/codex.sh | bash -s -- "粘贴你的APIKey" "desktop"写入 config.toml 和 auth.json，不安装 CLI。
打开终端：Command + 空格，搜索 Terminal。
将 粘贴你的APIKey 替换为真实 Key 后执行。
curl -fsSL https://console.novamodelhub.com/install/codex.sh | bash -s -- "粘贴你的APIKey" "cli"缺少 CLI 时，脚本会提示安装环境。
出现 Codex 配置已完成 后，按提示回车结束。
中途报错时保留错误信息，按第 6 步排查。
重启并验证
完全退出客户端后重新打开，仅关闭窗口可能不会生效。
- 右键 Dock 中的 Codex，选择 Quit / 退出。
- 或在菜单栏选择 Codex → Quit Codex。
- 从应用程序或 Dock 重新打开。
退出旧会话，重新启动：
codex发送一个简单请求，确认收到响应，再到用量查询核对 Key 状态。
检查配置
连接失败时，打开配置目录核对文件与备份：
open ~/.codex向支持人员提供文件名和报错信息时，请隐藏 Key，不公开完整 auth.json。
准备配置
桌面客户端与 CLI 均可手动配置；已有配置时先备份。
创建配置目录
mkdir -p ~/.codex写入 config.toml
文件位置：~/.codex/config.toml。
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.novamodelhub.com"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true写入 auth.json
替换为你的真实 API Key：
{
"OPENAI_API_KEY": "粘贴你的APIKey"
}重启并验证
检查配置
连接失败时，打开目录核对配置：
open ~/.codex向支持人员提供文件名和报错信息时，请隐藏 Key，不公开完整 auth.json。
常见问题
提示找不到 codex 命令
按 CLI 安装步骤补齐环境，再重新打开终端。桌面客户端用户无需安装 CLI。
出现 401、429 或连接中断
401 先核对 Key 与接口地址；429 检查错误详情、额度及频率限制；连接中断时检查网络与客户端提示。可通过用量查询确认套餐状态。
如何恢复原来的配置？
默认目录为 ~/.codex。将配置前保存的对应文件恢复后重启客户端；如果设置过其他配置目录，核对实际读取位置。排错时隐藏 Key，不公开完整 auth.json。