Codex 桌面端接入 ooioo

先从桌面客户端下载获取官方安装包。当前官方产品名为 ChatGPT 桌面端，安装后使用其中的 Codex 本地任务。

配置模型服务

完全退出桌面端后，编辑用户目录下的 ~/.codex/config.toml；Windows 对应 %USERPROFILE%\.codex\config.toml。已装 Codex CLI 的用户复用同一份配置。

保留已有的其他配置，合并以下内容。model 与 model_provider 放在文件顶层，不能误放在其他 [表名] 下；同名字段和 [model_providers.ooioo] 不要重复添加。

toml

model = "gpt-5.6-sol"
model_provider = "ooioo"

[model_providers.ooioo]
name = "ooioo"
base_url = "https://ooioo.work/v1"
env_key = "OOIOO_API_KEY"
wire_api = "responses"
requires_openai_auth = false

模型名以模型广场与你的密钥权限为准。请修改用户级配置，不要把上述服务配置放进项目的 .codex/config.toml。

让桌面端读取密钥

在控制台创建密钥，将 sk-你的Token 替换为实际值。不要把密钥放进项目、截图或聊天记录。

macOS

从 Dock 启动的应用通常不会读取 ~/.zshrc 中的变量。终端执行：

bash

launchctl setenv OOIOO_API_KEY "sk-你的Token"

随后重新打开桌面端。这个变量作用于当前登录会话，注销或重启电脑后需要重新设置；仅关闭并重新打开应用不需要重复设置。

Windows

在 PowerShell 中设置用户环境变量：

powershell

[Environment]::SetEnvironmentVariable("OOIOO_API_KEY", "sk-你的Token", "User")

完全退出后重新启动桌面端；如果仍读不到新变量，注销 Windows 后重新登录。

Linux

从设置了变量的终端启动桌面端：

bash

export OOIOO_API_KEY="sk-你的Token"
chatgpt

如果从桌面菜单启动，需要将变量加入桌面会话环境；仅修改终端的 shell 配置不一定生效。

验证接入

打开 Codex，选择本地文件夹并创建本地任务。
发送一条简短请求，例如“仅回复：连接成功”。
到 ooioo 控制台 → 使用日志，确认出现对应模型的请求。成功显示回复且日志存在，才算接入成功。

模型请求走 https://ooioo.work/v1，不需要代理访问 OpenAI 模型接口。ooioo 密钥不用于 ChatGPT 账号登录；ChatGPT 页面、云端任务和外部插件仍有独立的网络与账号要求。

如果当前桌面版本仍要求登录或不能进入自定义服务的本地任务，不要把 ooioo 密钥填入 ChatGPT 官方登录框；可以先使用 Codex CLI 或 OpenCode，并反馈客户端版本。本页配置依据官方自定义服务文档整理，尚未逐个系统完成桌面端首次调用验收。

常见问题

现象	处理方法
提示缺少 `OOIOO_API_KEY`	确认环境变量设置到了桌面进程，完全退出后重开；macOS 注销后需重设
仍连接 OpenAI 官方服务	检查用户级配置的 `model_provider`，排除重复字段，确认选择的是 Codex 本地任务
`401` / `402`	检查密钥、额度和价格保护，见 FAQ
更新后无法使用	记录版本和报错，核对本页最新配置；不要将 `wire_api` 改成 `chat`，当前 Codex 只支持 `responses`

参考：官方自定义模型服务配置、配置字段说明、认证与功能限制。

Codex 桌面端接入 ooioo ​

配置模型服务 ​

让桌面端读取密钥 ​

macOS ​

Windows ​

Linux ​

验证接入 ​

常见问题 ​