IINA Docs

Appearance

OpenAI Codex 配置指南 ​

Codex Version

Codex 是 OpenAI 推出的 AI 编程助手，支持 App、IDE 扩展、CLI 和云端等形态。

以下配置以默认端点 iina.ai 为例，如需使用国内加速端点，请将 iina.ai 替换为 acc.iina.ai。

同一份配置对 Codex CLI 和 Codex App 同样生效。

安装 Codex ​

Codex App：从 Codex 官网 下载安装。

Codex CLI：

shell
# 安装
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 更新
codex update
shell
# 安装
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# 更新
codex update
shell
# 安装
npm install -g @openai/codex

# 更新
npm install -g @openai/codex@latest
shell
# 安装
brew install --cask codex

# 更新
brew upgrade --cask codex

配置 API 密钥 ​

  1. 获取 API 密钥：登录控制台新建令牌，建议留空 模型限制列表 以支持所有模型。

  2. 修改配置：

    ~/.codex/config.toml
    toml
    model_provider = "iina"
model = "gpt-5.5"
model_reasoning_effort = "high"
model_reasoning_summary = "auto"

[model_providers.iina]
name = "iina"
base_url = "https://iina.ai/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
http_headers = {Authorization = "Bearer <YOUR_API_KEY>"}

# 关闭外发遥测与上报
[analytics]
enabled = false

[feedback]
enabled = false

[otel]
exporter = "none"
metrics_exporter = "none"
trace_exporter = "none"
log_user_prompt = false

自定义模型列表和上下文长度 ​

Codex 对自定义 provider 的模型套用约 272k 的上下文（界面按 95% 显示约 258k），可以用 model catalog 覆盖默认模型列表和上下文窗口。

WARNING

Codex 版本更新后内置模型和提示词可能变化，需要重新执行以下步骤

下面两种方式任选其一，生成目录文件 ~/.codex/iina-models.json。

方式一：从远程拉取（推荐，跨平台） ​

下载预生成好的模型配置：

shell
curl -s https://codex.iinawork.com/models.json -o ~/.codex/iina-models.json

方式二：本地用 jq 生成 ​

适合想自己增删模型或调整窗口的场景（需 jq）。命令会导出 Codex 内置模型配置、筛选模型、改写上下文窗口后写入文件，并保留 base_instructions 等原始字段：

shell
codex debug models --bundled \
  | sed -n '/^[[:space:]]*{/,$p' \
  | jq '
      def wanted: ["gpt-5.5", "gpt-5.4", "gpt-5.4-mini"];

      def set_window($n):
        .context_window = $n
        | .max_context_window = $n
        | .effective_context_window_percent = 95;

      {
        models: [
          .models[]
          | select(.slug as $s | wanted | index($s))
          | if .slug == "gpt-5.4-mini" then
              set_window(400000)
            else
              set_window(1050000)
            end
        ]
      }
    ' > "$HOME/.codex/iina-models.json"

启用 ​

在 ~/.codex/config.toml 顶部（[model_providers.iina] 之前）加一行，并重启 Codex：

toml
model_provider = "iina"
model_catalog_json = "iina-models.json"   # 相对路径，按 config.toml 所在目录解析，即 ~/.codex/iina-models.json
# ...其余配置保持不变

使用 Codex ​

配置完成后，可以通过 codex 命令使用 Codex。更多用法请参考官方文档：Codex App、IDE 扩展、Codex CLI。