16688AI使用文档
使用指南

Codex 接入教程

更新于 2026 年 11 月 2 日 · 16688AI

方式一:直接配置

  1. 先按快速开始创建并复制密钥。确认电脑上已安装 Codex CLI:在 PowerShell 输入 codex --version;若提示找不到命令,先按官方安装说明安装。
  2. Windows 打开文件资源管理器,在地址栏输入 %USERPROFILE%\.codex 并回车。macOS / Linux 对应 ~/.codex。
  3. 找到 config.toml,先复制一份作备份,再用文本编辑器打开。没有文件时创建纯文本文件,确认文件名不是 config.toml.txt。
  4. 将下面配置合并进去: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_providerai16688必须和 [model_providers.ai16688] 中的名称一致
modelgpt-5.6-sol要调用的模型 ID
base_urlhttps://api.16688.org/v1不填主站首页,不附加 /responses
wire_apiresponsesCodex 使用的接口协议
env_keyAPI_16688_KEY从这个环境变量读取密钥

在 PowerShell 中输入下面两行;第一行的 sk-*** 换成自己的密钥。然后在同一个窗口启动 Codex:

PowerShell
$env:API_16688_KEY = 'sk-***'
codex

macOS / Linux 使用 export API_16688_KEY='sk-***',然后运行 codex。环境变量只对当前终端及从这里启动的程序生效;从桌面图标打开的程序未必继承。

启动后发送“只回复 OK”。收到 OK 后,在本站使用日志中确认对应模型与调用时间。配置中的 supports_websockets = false 让本教程使用已经验证的 HTTP 流式路径;本教程不据此判断其他传输方式是否可用。

方式二:从本站导入 CC Switch

  1. 先安装并打开 CC Switch。
  2. 打开本站API 密钥页面,找到要使用的密钥,点击这一行的三个点菜单,再点“CC Switch”。
  3. 在弹窗“应用”中选择 Codex;“名称”填 16688AI;“主模型”选择或输入 gpt-5.6-sol。
  4. 点击“打开 CC Switch”。浏览器询问是否打开已安装的程序时,确认目标程序确实是 CC Switch。
  5. 在 CC Switch 导入预览中核对:应用为 Codex、服务地址为 https://api.16688.org/v1、模型为所选 ID、密钥来自自己的账号,再确认导入。不要分享这条导入链接,它包含密钥。
  6. 在 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 项目文档。本站是否兼容以本页验证范围为准。