Codex APP 配置指南

Codex 是 OpenAI 官方推出的 AI 编程助手，提供桌面 APP 和终端 CLI 两种形态，均可通过 1xm 中转服务接入，无需订阅 ChatGPT Plus 即可使用 GPT-5 Codex 全系列模型。

一、Codex 桌面 APP 配置

Codex APP 是 OpenAI 官方推出的桌面版 AI 编程工具，界面简洁，可直接操作本地文件和项目目录，适合不想折腾命令行的用户。

1. 下载安装

前往 OpenAI 官方网站 或 App Store 下载 Codex 桌面 APP，支持 macOS 和 Windows。

2. 首次启动与登录

首次打开 Codex APP，会出现以下界面，要求输入 OpenAI API 密钥：

此处填入你的 1xm API Key（格式：sk-xxxxx），而非 OpenAI 官方密钥，即可完成登录。

如何获取 API Key

登录 1xm.ai 后，进入「控制台 → 令牌」页面，创建新令牌获取 API Key。

3. 配置 1xm 供应商

推荐：使用 CC Switch 管理供应商

强烈推荐使用 CC Switch 完成此步骤。 CC Switch 是专为 Codex/Claude Code 设计的供应商管理工具，提供图形化界面，支持一键切换、热重载，无需手动编辑配置文件。

下图即为 CC Switch 的「编辑供应商」界面：

在 CC Switch 的「编辑供应商」页面，按如下填写：

字段	填写内容
供应商名称	1XM（自定义，方便识别）
官网链接	https://1xm.ai
API Key	你的 1xm API Key（sk-xxxxx）
API 请求地址	https://1xm.ai/v1
模型名称	gpt-5.4（或其他模型，见下方列表）

填写完成后，CC Switch 会自动生成 auth.json 和 config.toml 并写入通用配置，内容如下：

auth.json：

{
  "OPENAI_API_KEY": "你的1xm API Key"
}

config.toml：

model_provider = "1xm"
model = "gpt-5.4"
model_reasoning_effort = "low"
disable_response_storage = true

[model_providers.1xm]
name = "1xm"
base_url = "https://1xm.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

提示

model_reasoning_effort 可以按需调整推理强度：low（快速）、medium（均衡）、high（深度推理）。

如需管理多个供应商或频繁切换，推荐使用 CC Switch，无需每次手动编辑文件。

4. 开始使用

配置完成后，点击「新线程」，选择本地项目目录即可开始使用：

在输入框中直接描述任务，Codex 会读取本地文件并给出代码修改建议：

Codex APP 可以直接在本地工作区修改文件、运行终端命令、查日志，完全不需要手动复制粘贴代码。

---

二、Codex CLI 配置

安装前准备

• Node.js 22+、npm 10+（运行 node -v 确认版本）
• Windows 用户建议在 WSL 环境中使用，稳定性更好

1. 安装 Codex CLI

macOS / Linux：

npm install -g @openai/codex

Windows（PowerShell / CMD）：

npm install -g @openai/codex

验证安装成功：

codex --version

2. 配置 1xm 中转服务

Codex 通过 ~/.codex/ 目录下的两个文件读取 API 密钥和模型配置：

• Windows：C:\Users\你的用户名\.codex\
• macOS / Linux：~/.codex/

第一步：创建 auth.json（存放 API Key）

{
  "providers": {
    "1xm": {
      "token": "你的1xm API Key"
    }
  }
}

第二步：创建 config.toml（存放模型和网关配置）

model_provider = "1xm"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.1xm]
name = "1xm"
base_url = "https://api.1xm.ai/v1"
wire_api = "responses"
requires_openai_auth = true

配置说明

• model：填写要使用的模型名，如 gpt-5.4、gpt-5.3-codex、gpt-5.2-codex 等（以 1xm 模型列表 为准）
• model_provider 的值必须与 [model_providers.xxx] 的名称完全一致，此处均为 1xm
• base_url 固定填写 https://api.1xm.ai/v1（末尾带 /v1）
• wire_api = "responses" 是 Codex 接入 OpenAI Responses API 的必要配置
• ⚠️ 修改配置后必须重启终端才能生效！Windows 用户还需在任务管理器中结束相关 node.exe 进程，否则旧的环境变量缓存会导致新配置不生效。

如何获取 API Key

登录 1xm.ai 后，进入「控制台 → 令牌」页面，创建新令牌获取 API Key（格式：sk-xxxxx）。

3. 启动 Codex

进入项目目录后运行：

cd 你的项目目录
codex

也可以直接带任务启动：

codex "帮我看下这个项目的结构，列出主要文件"
codex "找出 src/index.js 中潜在的 bug"

4. 配置 VS Code 插件（可选）

完成上述 .codex 配置后，可以在 VS Code 中安装 Codex 插件获得图形化界面。

1. 打开 VS Code，按 Ctrl+Shift+X（macOS：Cmd+Shift+X）打开扩展面板
2. 搜索 Codex，安装 OpenAI 官方插件
3. 安装完成后，侧边栏会出现 Codex 图标面板
4. 插件会自动读取 ~/.codex/ 目录下的配置，无需重复填写

TIP

VS Code 插件与 CLI 共享同一套配置文件，修改 auth.json 或 config.toml 后重启 VS Code 即可生效。

5. 推荐模型

通过 1xm 接入 Codex（APP 和 CLI 均适用），以下模型可供选择：

模型	特点	推荐场景
gpt-5.4	最新旗舰，综合能力最强	复杂项目重构、架构设计
gpt-5.3-codex	强推理，支持 thinking	算法难题、代码调试
gpt-5.2-codex	均衡性价比，支持 thinking	日常编程辅助

• APP 用户：在设置的「模型名称」字段中直接修改即可
• CLI 用户：在 config.toml 中修改 model 字段，修改后重启终端生效

常见问题

Q：命令找不到（codex: command not found）

npm 全局路径未加入系统 PATH。重新安装或将 npm 全局 bin 目录手动添加到 PATH：

# macOS / Linux
echo 'export PATH="$(npm root -g)/../.bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Q：401 未认证

检查 auth.json 中 token 字段格式是否正确，provider 名称是否与 config.toml 中的 model_provider 完全一致，然后重启终端。

Q：模型不可用（model not found）

模型名称需与 1xm 模型列表 完全一致，包括大小写和连字符。

Q：config.toml 配置没有生效

确认 model_provider = "1xm" 与 [model_providers.1xm] 名称一致，且文件保存在 ~/.codex/config.toml（不是项目目录），修改后重启终端。

Q：Windows 下重启终端后仍不生效

打开任务管理器，找到并结束所有 node.exe 进程，再重新打开终端。