跳到主要内容

Codex 配置（ChatGPT APP 配置）

Orbit AI API 团队2026/07/11约 3 分钟阅读

本页是手动配置 Codex 的替代方案。优先推荐使用 AI Toolbox 的 Codex 教程，可通过图形界面管理供应商、模型和密钥。

1. 确认 Codex 已安装​

先完成 环境检查，再在终端执行：

codex --version

命令能返回版本号后继续。首次启动 codex 后会创建用户级配置目录。

2. 打开 Codex 配置目录​

  1. 按下 Win + R，输入以下内容并回车：
%USERPROFILE%\.codex
截图位置：Windows 运行窗口与 Codex 配置目录展示 Win + R、目录路径和 .codex 文件夹内容。

Linux 用户使用相同的 ~/.codex 目录。

3. 了解主要文件​

目录中可能存在以下文件。我们用到三个文件，其中需要实际配置前两个；其余文件可先忽略：

  • config.toml：Codex 的核心用户级配置文件，中转服务、模型供应商与 MCP 等配置均可在这里定义。
  • auth.json：存放从 Orbit AI API 控制台获取的 API Key。
  • AGENTS.md：用于设置 Codex 全局工作的提示词；暂时不需要时可保持为空。

:::danger 重要

初次安装时若未自动生成，请手动创建上述三个文件。随后按下一步配置 config.toml 和 auth.json。

:::

4. 配置 config.toml​

将 MODEL_NAME 替换为模型广场中的完整模型名称，然后把以下内容写入用户级 config.toml：

model = "MODEL_NAME"
model_provider = "orbitai"
model_reasoning_effort = "high"
model_verbosity = "high"
disable_response_storage = true

[model_providers.orbitai]
name = "Orbit AI API"
base_url = "https://orbitaiapi.site/v1"
wire_api = "responses"
requires_openai_auth = true

自定义供应商必须写在用户级 ~/.codex/config.toml 中，不要写到项目的 .codex/config.toml。model_reasoning_effort 和 model_verbosity 可按模型能力调整。

5. 配置 API Key​

回顾 创建 API Key，在控制台创建可用于 Codex 的令牌，并将以下内容写入 auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

将 YOUR_API_KEY 替换为实际 Key 后保存。不要把 Key 提交到代码仓库、截图或前端应用中。

6. 测试对话​

在 Windows、macOS 或 Linux 终端执行：

codex

进入交互界面并能正常回复，即表示配置成功。若出现认证或模型错误，请依次检查 config.toml、auth.json、Base URL、模型名称、令牌状态和模型的 Responses API 兼容性。