搜索文档...

开始输入以搜索文档

OpenAICodex CLI

OpenAI Codex CLI 配置指南

分步指导您在 Windows、macOS 和 Linux 上安装并配置 Codex CLI 与 UnoRouter。

什么是 Codex CLI?

Codex CLI 是 OpenAI 推出的编程代理,可在您的电脑本地运行。

特性

终端原生完全在终端中运行,无需浏览器或编辑器。
工具驱动使用工具读取、编写并执行项目中的代码。
原子补丁以原子补丁方式应用变更,每次编辑都便于审阅。
沙箱隔离在沙箱环境中执行命令以保护您的系统。
计划跟踪将任务拆解为步骤、跟踪进度,并解释正在做什么。
多模态输入接受文本、图像和文件引用作为输入上下文。

使用 CC Switch 快速配置

使用 CC Switch 一键配置提供方。它会自动为您设置 API 端点和提供方名称。

登录以自动填入您的 API 密钥

或使用 CC Switch 命令行:

bash
cc-switch provider add

手动配置

永久配置文件(推荐)

在会话之间和终端重启时均保留。

%APPDATA%\codex\auth.json

json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

登录以自动填入您的 API 密钥

%APPDATA%\codex\config.toml

toml
model = "gpt-5.4"

[model_providers.custom]
base_url = "https://api.unorouter.ai/v1"
wire_api = "responses"

登录以自动填入您的 API 密钥

环境变量

添加到您的 shell 配置文件中。终端关闭后重置,除非从配置文件中加载。

powershell
$env:OPENAI_BASE_URL="https://api.unorouter.ai/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

登录以自动填入您的 API 密钥

安装

步骤 2:安装 WSL

需要 Windows Subsystem for Linux。运行以下命令:

powershell
wsl --install

步骤 3:安装 Codex CLI

bash
npm i -g @openai/codex

准备好开始了吗?

获取 API 密钥,在 Codex CLI 中开始使用 UnoRouter。