Codex 接入 KongKong AI 配置教程
本文说明如何在本地 Codex 中接入 KongKong AI。配置完成后,Codex 会通过 KongKong AI 的 API 入口调用模型能力。
如果还没有 API Key,请先进入 KongKong AI 密钥页面 创建或查看密钥。
Codex 需要配置两类信息:
~/.codex/auth.json:保存 API Key。~/.codex/config.toml:保存模型和 API 根地址。
KongKong AI 的 API 根地址为:
https://kongkongai.com/v1该地址是 base_url,不是完整的请求路径。用于验证连通性的 chat/completions 示例中,完整地址为 https://kongkongai.com/v1/chat/completions,因此在 Codex 配置中只需要填写到 /v1。
macOS 配置
Section titled “macOS 配置”确认已安装 Codex CLI:
npm install -g @openai/codex创建 Codex 配置目录:
mkdir -p ~/.codex编辑认证文件:
nano ~/.codex/auth.json写入 API Key:
{ "auth_mode": "apikey", "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxx"}编辑 Codex 配置文件:
nano ~/.codex/config.toml写入以下配置:
model_provider = "OpenAI"model = "gpt-5.5"
[model_providers.OpenAI]name = "OpenAI"base_url = "https://kongkongai.com/v1"wire_api = "responses"保存后重新打开终端。
Windows 配置
Section titled “Windows 配置”在 PowerShell 中安装 Codex CLI:
npm install -g @openai/codex创建 Codex 配置目录:
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"打开认证文件:
notepad "$env:USERPROFILE\.codex\auth.json"写入 API Key:
{ "auth_mode": "apikey", "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxx"}打开 Codex 配置文件:
notepad "$env:USERPROFILE\.codex\config.toml"写入以下配置:
model_provider = "OpenAI"model = "gpt-5.5"
[model_providers.OpenAI]name = "OpenAI"base_url = "https://kongkongai.com/v1"wire_api = "responses"保存文件后,重新打开 PowerShell。
进入任意项目目录,运行:
codex也可以用一句简单任务测试:
codex "Say hello in one sentence."如果能够正常返回结果,即表示 Codex 已通过 KongKong AI 完成接入。
base_url必须填写 API 根地址https://kongkongai.com/v1。auth.json中使用的字段名为OPENAI_API_KEY,即使接入的是 KongKong AI,也保持该字段名不变。- 不要把
auth.json写入项目仓库或公开文档。 - 如果修改了
auth.json或config.toml,请重新打开终端后再运行 Codex。