Codex CLI 接入 kukuai.fyi
Codex CLI 使用 kukuai.fyi 的模型接入、OAuth 切换、插件限制和工具恢复教程。
Codex CLI 使用 kukuai.fyi 的模型接入、OAuth 切换、插件限制和工具恢复教程。
Codex CLI 作为开发工具接入 kukuai.fyi 时，核心是三件事：安装 CLI、配置https://www.kukuai.fyi/api-proxy/china/v1、用一个会写文件的最小任务验证工具链。 如果遇到插件不可用，要先判断自己是不是还在 API Key 模式。
准备工作
checklisttext
1. 已安装 Codex CLI
2. 已准备 kukuai.fyi API Key
3. 已确认当前要走 API Key 模式还是 OAuth 模式
4. 已确认 OpenAI 兼容 Base URL: https://www.kukuai.fyi/api-proxy/china/v1
5. 已准备一个最小验证任务，例如“创建一个 hello.txt”第一步：安装 Codex CLI
如果本机还没有 Codex CLI，先安装并确认命令可用。
install.shbash
# macOS / Linux
npm install -g @openai/codex
# 验证安装
codex --version第二步：配置 API Key 模式
API Key 模式用于普通模型调用。配置时重点检查 base_url 是否带/v1，以及模型名是否是 kukuai.fyi 当前支持的真实模型 ID。
~/.codex/config.tomltoml
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://www.kukuai.fyi/api-proxy/china/v1"
wire_api = "responses"
requires_openai_auth = true
[profiles.kukuai]
model_provider = "OpenAI"
model = "gpt-5-2-chat-latest"如果你更习惯用环境变量，也可以在当前终端设置：
.envrcbash
export OPENAI_API_KEY="sk-你的-kukuai-api-key"
export OPENAI_BASE_URL="https://www.kukuai.fyi/api-proxy/china/v1"第三步：验证文件工具
不要只问一句聊天问题。Codex 是代码代理，最重要的是确认“能读文件、能写文件、能继续执行任务”。
verify.shbash
codex --profile kukuai
# 进入会话后输入：
请创建一个 hello.txt，内容为 hello kukuai，并检查文件是否写入成功。- 启动 Codex CLI。
- 让它创建一个简单文件。
- 让它读取并确认文件内容。
- 如果文件工具不可用，先修复工具状态，不要先换模型。
OAuth 与插件能力
oauth-notestext
1. 只需要模型调用：使用 API Key 模式
2. 需要 ChatGPT 账号插件能力：退出 API Key，使用 OAuth 登录
3. OAuth 模式不要保留 OPENAI_API_KEY / OPENAI_BASE_URL 污染环境
4. 使用 CC-Switch 时，需要确认路由已经开启
5. 切换模式后，重新开启一个 Codex 会话验证如果你要的是插件能力，继续看 Codex 插件 OAuth 教程。 如果你只是要稳定调用 kukuai.fyi 模型，API Key 模式更直接。
排障清单
troubleshootingtext
1. 每次新会话反复 reconnect
- 先检查代理变量和旧的 API Key 环境变量
- 清理后重新打开终端
2. 工具突然不可调用，代码不能落地
- 让 Codex 检查当前文件工具是否可用
- 工具恢复后，明确告诉 Codex: 工具已恢复，直接从第一步开始落代码
- 这通常不是模型问题，而是会话工具状态问题
3. 返回 401
- API Key 不正确或权限不足
4. 返回 404
- Base URL 或模型名写错
5. 插件功能不可用
- 如果你是 API Key 登录，这是正常限制
- 退出 API Key 登录，改用 OAuth扩展阅读
- freestylefly/CodexGuide — Codex 入门、CLI 配置、工作流和实践经验整理，可作为 kukuai.fyi Codex 接入教程之外的补充参考。