首次使用准备
Codex 软件安装
已安装桌面版?直接进入第 2 步。否则先安装:
从 Codex 官方页面安装适合系统的版本。安装后先完全退出客户端,再执行本页的配置脚本。
准备账号
注册 api.99off.net 并创建 API Key
gpt-codex
请确认令牌具有所选 Codex 模型的使用权限。
- 访问 api.99off.net,注册并登录。
- 打开“令牌管理”→“添加令牌”,选择
gpt-codex分组。 - 创建后复制 API Key,留待安装时输入。
下载文件
下载配置包
首次安装请下载完整包,解压后按第 4 步操作。
单独下载: config.toml 模板 · 模型目录 JSON
包含以上 5 个模型,新安装默认使用 gpt-6.1-sol。
先退出 Codex,解压升级包。脚本会备份配置并更新模型列表,保留现有模型选择;若选用已下架模型,请自行切换。
Windows 升级包:解压后双击 update-windows.cmd。
Mac 升级包:在终端进入解压目录,运行 sh ./update-macos-linux.sh。
升级只更新模型目录,不更改默认模型或 API Key。
自动安装
执行脚本自动安装
- 右键 ZIP,选择“全部解压”。
- 打开解压后的文件夹,双击
install-windows.cmd。 - 复制第 2 步的真实 Key,终端右键粘贴;看到星号掩码(
*****)后按回车。
- 在 Finder 中双击 ZIP 解压。
- 打开终端,输入
cd,把解压后的文件夹拖入终端并回车。 - 运行下面的命令,按提示输入真实 Key:
sh ./install-macos-linux.sh
脚本会将 Key 保存到登录钥匙串,重启电脑后仍可使用。
下载 update-macos-key.sh 到“下载”文件夹,然后运行:
cd ~/Downloads
sh ./update-macos-key.sh
按提示输入新 Key;无需重装配置包。
配置说明
脚本会写入什么
model默认模型:gpt-6.1-solmodel_provider99Off.netbase_urlhttps://api.99off.net/v1env_key读取 OPENAI_API_KEY查看 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 配置
model = "gpt-5.6-sol"
model_provider = "99off"
model_reasoning_effort = "xhigh"
这是可选文件,普通用户不需要手动创建。
完成接入
重启并验证
完全退出并重新打开 Codex。
新建对话,选择 gpt-6.1-sol 或其他已授权模型。
发送一条测试消息,确认收到回复。
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"。