跳转到内容

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

确认已安装 Codex CLI:

Terminal window
npm install -g @openai/codex

创建 Codex 配置目录:

Terminal window
mkdir -p ~/.codex

编辑认证文件:

Terminal window
nano ~/.codex/auth.json

写入 API Key:

{
"auth_mode": "apikey",
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxx"
}

编辑 Codex 配置文件:

Terminal window
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"

保存后重新打开终端。

在 PowerShell 中安装 Codex CLI:

Terminal window
npm install -g @openai/codex

创建 Codex 配置目录:

Terminal window
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"

打开认证文件:

Terminal window
notepad "$env:USERPROFILE\.codex\auth.json"

写入 API Key:

{
"auth_mode": "apikey",
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxx"
}

打开 Codex 配置文件:

Terminal window
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。

进入任意项目目录,运行:

Terminal window
codex

也可以用一句简单任务测试:

Terminal window
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.jsonconfig.toml,请重新打开终端后再运行 Codex。