吉格api 文档

切换主题

Codex CLI 使用指南 ​

Codex CLI 的自定义 provider 使用 Responses API。吉格api接入地址为 https://chickener.cc.cd/v1。

（一）安装 Codex CLI ​

macOS / Linux 可以使用官方安装脚本：

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以通过 npm 安装：

bash
npm install -g @openai/codex
codex --version

（二）接入吉格api ​

1. 设置 API Key ​

macOS / Linux：

bash
export JIGE_API_KEY="YOUR_API_KEY"

Windows PowerShell：

powershell
$env:JIGE_API_KEY = "YOUR_API_KEY"

2. 编辑配置文件 ​

配置文件位置：

  • macOS / Linux：~/.codex/config.toml
  • Windows：%USERPROFILE%\.codex\config.toml

写入：

toml
model = "YOUR_MODEL_ID"
model_provider = "jigeapi"

[model_providers.jigeapi]
name = "吉格api"
base_url = "https://chickener.cc.cd/v1"
env_key = "JIGE_API_KEY"
wire_api = "responses"
requires_openai_auth = false

将 YOUR_MODEL_ID 替换为模型广场中的实际模型 ID。

Responses API

当前 Codex CLI 的自定义 provider 使用 wire_api = "responses"，旧教程中的 wire_api = "chat" 已不再适用。服务端需要完整支持 Responses API、流式输出和工具调用，才能覆盖 Codex 的主要功能。

（三）开始使用 ​

先检查配置：

bash
codex doctor

进入交互界面：

bash
codex

也可以执行一次最小验证：

bash
codex exec -m YOUR_MODEL_ID "Reply with exactly: OK"

进入 Codex 后可使用 /status 查看当前 provider 和模型。

常见问题 ​

提示缺少环境变量 ​

env_key = "JIGE_API_KEY" 表示 Codex 会读取同名环境变量。设置持久化变量后，需要重新打开终端。

配置后仍要求 OpenAI 登录 ​

确认 provider 中存在：

toml
requires_openai_auth = false

并确认 model_provider 与 [model_providers.jigeapi] 的名称完全一致。

wire_api = "chat" 报错 ​

当前 Codex CLI 已移除该值，请使用 wire_api = "responses"。这不是 Chat Completions 的兼容开关。

能回复文本，但无法执行编码任务 ​

简单文本成功不能证明工具调用链完整。需要继续验证流式响应、函数调用、文件读取和多轮工具结果。如果这些能力失败，请保留 request id 联系支持。

项目配置没有应用 provider ​

provider 和认证信息应放在用户级 ~/.codex/config.toml。项目内 .codex/config.toml 可能忽略敏感或受限制的 provider 配置。