Protokener / DOCUMENTATION
Codex
示例使用占位密钥；模型与价格以实时目录为准。
平台配置入口
打开 API 密钥 → 客户端，选择对应工具。下图是本项目的真实配置区域，不是第三方软件界面。演示密钥与 MODEL_ID 均为占位数据，使用时请选择你自己的密钥与实时模型。
推荐：通过 CC Switch 导入
在平台打开 API 密钥 → 客户端 → Codex，选择有效密钥和已授权模型，再点击“导入 CC Switch”。CB／WB 及其他客户端继续使用原入口。
- 打开 https://ccswitch.io/zh/，点击免费下载，选择适合系统和芯片的安装包。
- 核对平台确认框中的客户端、地址、模型和掩码密钥，再打开 CC Switch，并在应用内确认导入。
- 在 CC Switch 对应客户端的供应商列表中启用 Protokener，核对实际配置目录。不要同时启用多层代理或自动重试。
- 完全退出客户端、重新启动并新建会话，发送 Reply exactly: protokener-ok，再检查平台用量。该消息按当前套餐或钱包规则计费。
导入复用所选密钥，不额外创建业务密钥，也不增加额度。完整密钥仅在操作时取回，交给本机 CC Switch 保存；不要转发导入链接。网页无法确认应用是否成功导入，未打开时可使用下方手动配置。
如果设置 CODEX_HOME，CC Switch 必须选择相同目录。Codex 桌面端也需要验证配置目录及认证方式，不能仅凭 CLI 成功推断桌面端可用。
备用：手动配置
使用支持 Responses 协议的模型。在 API 密钥页选择 Codex CLI，可生成与你的模型选择对应的配置。下方示例需替换模型和密钥。
1. 合并配置
macOS / Linux：~/.codex/config.toml；Windows：%USERPROFILE%\.codex\config.toml。已有配置先备份，顶层字段放在 TOML 表段之前，同名 provider 不要重复定义。
model_provider = "protokener"
model = "YOUR_MODEL_ID"
[model_providers.protokener]
name = "Protokener"
base_url = "https://protokener.com/v1"
env_key = "PROTOKENER_API_KEY"
wire_api = "responses"2. 设置密钥并从同一终端启动
# macOS / Linux
export PROTOKENER_API_KEY='YOUR_API_KEY'
codex# Windows PowerShell
$env:PROTOKENER_API_KEY = 'YOUR_API_KEY'
codex上述环境变量仅对当前终端及其子进程生效。重开终端需要重新设置或使用系统安全的环境变量管理。先测试简单文本，再测试文件读取与工具调用。Codex 桌面应用的 provider 支持与 CLI 可能不同，本节不等同于已完成桌面端验证。
资料来源：front/docs-content/pages.json · codex