使用指南
Codex 接入教程
方式一:直接配置
- 先按快速开始创建并复制密钥。确认电脑上已安装 Codex CLI:在 PowerShell 输入
codex --version;若提示找不到命令,先按官方安装说明安装。 - Windows 打开文件资源管理器,在地址栏输入
%USERPROFILE%\.codex并回车。macOS / Linux 对应~/.codex。 - 找到
config.toml,先复制一份作备份,再用文本编辑器打开。没有文件时创建纯文本文件,确认文件名不是config.toml.txt。 - 将下面配置合并进去:
model_provider与model放在文件最上层,位于任何[分区]之前;同名字段只保留一份。已有 MCP 或其他设置无需删除。
config.toml
model_provider = "ai16688"
model = "gpt-5.6-sol"
[model_providers.ai16688]
name = "16688AI"
base_url = "https://api.16688.org/v1"
wire_api = "responses"
env_key = "API_16688_KEY"
requires_openai_auth = false
supports_websockets = false| 字段 | 本站填写值 | 作用 |
|---|---|---|
| model_provider | ai16688 | 必须和 [model_providers.ai16688] 中的名称一致 |
| model | gpt-5.6-sol | 要调用的模型 ID |
| base_url | https://api.16688.org/v1 | 不填主站首页,不附加 /responses |
| wire_api | responses | Codex 使用的接口协议 |
| env_key | API_16688_KEY | 从这个环境变量读取密钥 |
在 PowerShell 中输入下面两行;第一行的 sk-*** 换成自己的密钥。然后在同一个窗口启动 Codex:
PowerShell
$env:API_16688_KEY = 'sk-***'
codexmacOS / Linux 使用 export API_16688_KEY='sk-***',然后运行 codex。环境变量只对当前终端及从这里启动的程序生效;从桌面图标打开的程序未必继承。
启动后发送“只回复 OK”。收到 OK 后,在本站使用日志中确认对应模型与调用时间。配置中的 supports_websockets = false 让本教程使用已经验证的 HTTP 流式路径;本教程不据此判断其他传输方式是否可用。
方式二:从本站导入 CC Switch
- 先安装并打开 CC Switch。
- 打开本站API 密钥页面,找到要使用的密钥,点击这一行的三个点菜单,再点“CC Switch”。
- 在弹窗“应用”中选择 Codex;“名称”填
16688AI;“主模型”选择或输入gpt-5.6-sol。 - 点击“打开 CC Switch”。浏览器询问是否打开已安装的程序时,确认目标程序确实是 CC Switch。
- 在 CC Switch 导入预览中核对:应用为 Codex、服务地址为
https://api.16688.org/v1、模型为所选 ID、密钥来自自己的账号,再确认导入。不要分享这条导入链接,它包含密钥。 - 在 Codex 的服务商列表中选中刚导入的“16688AI”,按当前版本的“启用”或切换按钮使它生效;关闭旧 Codex 会话,重新启动并发送“只回复 OK”。
如果导入预览出现 localhost:3000
这是需要核对的配置来源问题。先取消导入,回到地址栏确认自己打开的是 https://api.16688.org,刷新页面并重新登录后再试。仍错误时,在 CC Switch 的 Codex 服务商编辑页,将服务地址手动改为 https://api.16688.org/v1,保存并重新启动 Codex。
本次对构建源码和公开站点配置的复现结果:正常新配置会生成上述公开地址;把缓存地址设为 localhost:3000 时,生成函数仍会沿用它。因此,旧缓存残留是需要排查的风险。本轮未完成真实浏览器导入复验,不能将历史问题宣称为“彻底修复”。CC Switch 主动开启本地路由后,工具配置可能按其机制指向本机代理;此时仍须核对服务商卡片里的真实服务地址。
字段依据:OpenAI 配置参考;导入机制:CC Switch 项目文档。本站是否兼容以本页验证范围为准。