Codex 桌面版

Codex 接入 99Off.net

安装软件、创建 Key、运行配置脚本,即可使用 99Off.net。已有配置会先备份,再合并新设置。

模型
gpt-5.6-terra / gpt-5.6-sol / gpt-6-astra / gpt-6-sol / gpt-6.1-sol
API 地址
https://api.99off.net/v1
接口类型
responses
1

首次使用准备

Codex 软件安装

已安装桌面版?直接进入第 2 步。否则先安装:

从 Codex 官方页面安装适合系统的版本。安装后先完全退出客户端,再执行本页的配置脚本。

2

准备账号

注册 api.99off.net 并创建 API Key

令牌分组:gpt-codex

请确认令牌具有所选 Codex 模型的使用权限。

  1. 访问 api.99off.net,注册并登录。
  2. 打开“令牌管理”→“添加令牌”,选择 gpt-codex 分组。
  3. 创建后复制 API Key,留待安装时输入。
3

下载文件

下载配置包

codex-99off-template.zip

首次安装请下载完整包,解压后按第 4 步操作。

下载完整安装包

包含以上 5 个模型,新安装默认使用 gpt-6.1-sol。

已安装过?使用升级包,无需重新输入 Key

先退出 Codex,解压升级包。脚本会备份配置并更新模型列表,保留现有模型选择;若选用已下架模型,请自行切换。

Windows 升级包:解压后双击 update-windows.cmd。

Mac 升级包:在终端进入解压目录,运行 sh ./update-macos-linux.sh。

升级只更新模型目录,不更改默认模型或 API Key。

4

自动安装

执行脚本自动安装

Windows:解压后双击安装
  1. 右键 ZIP,选择“全部解压”。
  2. 打开解压后的文件夹,双击 install-windows.cmd。
  3. 复制第 2 步的真实 Key,终端右键粘贴;看到星号掩码(*****)后按回车。
Mac:解压后在终端运行
  1. 在 Finder 中双击 ZIP 解压。
  2. 打开终端,输入 cd ,把解压后的文件夹拖入终端并回车。
  3. 运行下面的命令,按提示输入真实 Key:
sh ./install-macos-linux.sh

脚本会将 Key 保存到登录钥匙串,重启电脑后仍可使用。

Mac 已安装用户:单独更新或修复 Key

下载 update-macos-key.sh 到“下载”文件夹,然后运行:

终端命令
cd ~/Downloads
sh ./update-macos-key.sh

按提示输入新 Key;无需重装配置包。

5

配置说明

脚本会写入什么

model默认模型:gpt-6.1-sol
model_provider99Off.net
base_urlhttps://api.99off.net/v1
env_key读取 OPENAI_API_KEY
查看 config.toml 配置示例
~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "99off"
model_catalog_json = "PATH_TO_99OFF_CODEX_MODELS_JSON"
model_reasoning_effort = "xhigh"
[model_providers.99off]
name = "99Off.net"
base_url = "https://api.99off.net/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
可选:查看 GPT-5.6 Sol 配置
~/.codex/sol.config.toml
model = "gpt-5.6-sol"
model_provider = "99off"
model_reasoning_effort = "xhigh"

这是可选文件,普通用户不需要手动创建。

6

完成接入

重启并验证

1

完全退出并重新打开 Codex。

2

新建对话,选择 gpt-6.1-sol 或其他已授权模型。

3

发送一条测试消息,确认收到回复。

收到正常回复,即表示配置完成。

Troubleshooting

常见问题

返回 401,提示没有读取到 API Key

Windows:重新运行 install-windows.cmd 并输入真实 Key。Mac:按第 4 步运行 update-macos-key.sh。完成后重启 Codex。

模型不显示、分组掉线或加密验证失败

确认 Key 属于第 2 步所示的 Codex 专用分组,退出 Codex 后重开,并新建对话。若提示 model not found,再检查模型目录路径。

出现 Responses Lite 或工具参数错误

检查 wire_api = "responses",以及模型目录中的 "use_responses_lite": false。

运行脚本后仍然没有切到 99Off.net

完全退出并重启 Codex;仍无效时,检查 ~/.codex/config.toml 中的 model_provider = "99off" 和 base_url = "https://api.99off.net/v1"。