创智AI
教程Codex CLI

Codex CLI 安装与配置

OpenAI Codex 是 AI 编程智能体，提供 CLI、桌面 App 和 IDE 扩展三种形态。本教程从零开始接入创智AI网关（已兼容 Responses API）， 配置一次，CLI、Codex 桌面 App 和 VS Code / Cursor 扩展同时生效。预计耗时 5 分钟。

1

安装 Node.js（v18 或更高版本）

Codex CLI 通过 npm 分发，需要 Node.js 运行环境。打开终端运行：

winget install OpenJS.NodeJS.LTS

验证安装：

node --version
npm --version

如果你已安装 Node.js v18+，可以跳过此步。

2

安装 Codex CLI

通过 npm 全局安装：

# 使用国内镜像源加速（推荐）
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 或使用默认源
npm install -g @openai/codex

验证安装：

codex --version
3

配置创智AI网关

Codex 的配置文件位于 C:\Users\你的用户名\.codex\config.toml。 先创建配置目录并打开配置文件：

# PowerShell 创建配置目录并打开配置文件
mkdir -Force $HOME\.codex | Out-Null
notepad $HOME\.codex\config.toml

把以下内容粘贴进去并保存：

# ~/.codex/config.toml
model = "gpt-5.3-codex"
model_provider = "genesis"

[model_providers.genesis]
name = "创智AI"
base_url = "https://api.my-genesis.top/v1"
env_key = "GENESIS_API_KEY"
wire_api = "responses"
requires_openai_auth = false

然后设置 API Key 环境变量。请将你的API_KEY替换为你在API Key 管理中创建的密钥。

# PowerShell 中设置环境变量
$env:GENESIS_API_KEY = "你的API_KEY"

# 永久设置（重启后仍有效）
[System.Environment]::SetEnvironmentVariable("GENESIS_API_KEY", "你的API_KEY", "User")
4

启动 Codex

在项目目录下启动（重新打开一个终端，确保环境变量生效）：

cd 你的项目目录
codex

首次启动如果询问登录方式，选择API key方式即可（不要选 ChatGPT 登录）。试着发一条消息，例如解释一下这个项目的结构， 能正常回复即接入成功。

桌面端：Codex 桌面 App / IDE 扩展

Codex 桌面 App（支持 macOS 和 Windows）、VS Code / Cursor 里的 Codex 扩展，和 CLI 共用同一份配置文件（~/.codex/config.toml）。 按上面第 3 步配置好之后，桌面端会自动继承，无需重复配置。

Codex 桌面 App
  1. 从 官方下载页 下载安装（macOS 选对应芯片版本；Windows 也可以在 Microsoft Store 搜索 Codex 安装）。
  2. 确保 GENESIS_API_KEY 已按第 3 步永久设置（Windows 用 SetEnvironmentVariable，macOS 写入 shell 配置文件）， 设置后重启 App 才能读到。
  3. 启动后登录方式选 OpenAI API key（不要选 Sign in with ChatGPT）。 配置里的 requires_openai_auth = false 会让它跳过 ChatGPT 登录要求。
  4. 选择项目文件夹，模式选 Local，发一条消息验证即可。
VS Code / Cursor 扩展
  1. 扩展市场搜索Codex – OpenAI's coding agent安装（发布者 OpenAI），同样选 API key 登录方式。
  2. 扩展里点右上角齿轮 → Codex Settings → Open config.toml 可直接打开配置文件检查；改完配置新建会话生效。

提示：用 API key 登录时，依赖 ChatGPT 账号的云端任务等功能不可用，本地编码功能不受影响。 macOS 下如果 App / IDE 读不到环境变量，从已 export 变量的终端里启动它（如open -a Codex或 code .）即可。

常见问题

提示 401 Unauthorized / API key 无效

检查 GENESIS_API_KEY 是否设置成功：在终端运行 echo $env:GENESIS_API_KEY。注意设置环境变量后需要重新打开终端才会生效。

可以用哪些模型？

推荐 gpt-5.3-codex（编程专用）。也可以在 config.toml 中把 model 改为其他模型 ID， 完整列表见模型列表。

启动后报 "stream error" 或没有响应

确认 config.toml 中 wire_api 设置为 "responses"、base_url 末尾带 /v1。 旧版本 Codex CLI 建议升级：npm update -g @openai/codex。

Windows 下运行异常？

Codex CLI 对 Windows 的原生支持仍在完善中，如遇问题推荐在 WSL（Ubuntu）里安装使用， 配置方法与 Linux 标签页相同。

获取 API Key →查看接入示例