---
url: /tutorial/integrations/codex-cli.md
---

# 通过 CloseAI 使用 OpenAI Codex

OpenAI Codex 是 OpenAI 出品的编程助手，在 GPT-5 推出后编程能力明显大幅提升，近期有超越 Claude Code 的趋势。CloseAI 提供了专用的配置可以一键启用，让您可以直接在终端中与强大的 Codex 模型进行交互。

通过本教程的简单配置，您就可以使用 CloseAI 统一的 API Key 来访问 Codex 模型，享受每日不限量的使用。

## 第一步：安装 OpenAI Codex

::: tip
Codex 有命令行和桌面端 App 两种形态，**两者共享同一套配置**，按需选择即可（日常更推荐命令行：免翻墙、更稳定便捷）。
:::

### 命令行（推荐）

使用 npm (Node Package Manager) 在您的系统上全局安装 Codex。请打开终端并运行以下命令：

```bash
npm install -g @openai/codex
```

安装成功后，您就可以在终端的任何位置使用 `codex` 命令了。

### 桌面端 App

从 [Codex 官方下载页](https://chatgpt.com/download/) 下载。页面里同时提供 ChatGPT 和 Codex 两个 App，**请向下滚动找到 Codex 的下载入口，不要下成顶部的 ChatGPT**（ChatGPT 不共享 Codex 配置）。

桌面端建议开 VPN 使用，不论是下载还是启动，如果没有VPN可能会卡死。

桌面端无需单独配置，安装后照本文把命令行配好即自动共享生效。

## 准备工作

在开始之前，请确保您已经拥有：

1. 一个 [CloseAI 账户](https://www.closeai.com/)。
2. 一个 CloseAI API Key。您可以在您的账户仪表板中生成和管理。
3. 已安装 [Node.js](https://nodejs.org/en/download/) (版本需 >= 18) 和 npm。

## 第二步：配置环境变量

配置环境变量是让 Codex 通过 CloseAI 运行的关键一步。我们需要设置您的 API Key 环境变量。

:::tabs
\== macOS / Linux

将以下命令添加到您的 shell 配置文件中 (例如 `~/.zshrc` 或 `~/.bashrc`)。

**请将 `sk-xxxxxxxx` 替换为您自己的 CloseAI API Key。**

```bash
export OPENAI_API_KEY="sk-xxxxxxxx"
```

添加完成后，执行以下命令使配置生效：

```bash
source ~/.zshrc  # 如果使用 zsh
# 或
source ~/.bashrc  # 如果使用 bash
```

\== Windows

Windows 请在 **PowerShell** 中使用 `setx` 命令设置**用户级持久化环境变量**（不要用 macOS/Linux 的 `export` 语法，PowerShell 不认）。请将 `sk-xxxxxxxx` 替换为您自己的 CloseAI API Key：

```powershell
setx OPENAI_API_KEY "sk-xxxxxxxx"
```

设置完成后，**关闭当前 PowerShell 窗口并重新打开一个**，运行以下命令验证是否生效：

```powershell
echo $env:OPENAI_API_KEY
```

能正确打印出您的 Key 即表示配置成功。

**⚠️ Windows 环境变量三大坑（90% 的报错都来自这里）**

1. **不要用 `export`**：那是 macOS/Linux 的写法，PowerShell 不认，敲了不会生效。
2. **不要用 `$env:OPENAI_API_KEY="..."` 这种临时写法**：它只对当前窗口生效，窗口一关就没了。
3. **`setx` 设置后必须关闭并重新打开终端**：`setx` 不会影响已经打开的窗口，新值只在之后新开的终端里才生效。

> 如果您习惯使用 Git Bash，也可以像 macOS/Linux 一样把 `export OPENAI_API_KEY="sk-xxxxxxxx"` 写入 `~/.bashrc`，再执行 `source ~/.bashrc` 生效。

:::

## 第三步：创建配置文件

创建 Codex 的配置目录和文件：

```bash
mkdir -p ~/.codex
```

然后创建配置文件 `~/.codex/config.toml`，并添加以下内容（Windows 对应路径为 `%USERPROFILE%\.codex\config.toml`，在 PowerShell 中同样可用 `mkdir ~/.codex` 创建目录，配置内容完全相同）：

**注意：在 TOML 格式中，根键（如 `model`、`model_provider`）必须写在顶部位置，在表格配置（如 `[model_providers.closeai]`）之前，不能追加到后面。**

```toml
model = "gpt-5.5"
model_provider = "closeai"

[model_providers.closeai]
name = "CloseAI"
base_url = "https://api.openai-proxy.org/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
```

## 第四步：开始使用

所有配置都已就绪！现在，您可以直接在终端中启动 Codex 了。

```bash
codex
```

程序启动后，您可以直接开始与 Codex 进行编程对话。由于我们已经配置了环境变量和配置文件，Codex 会自动使用您的 CloseAI API Key 并通过我们的服务进行连接，无需任何额外的手动认证步骤。

```
You: >> 帮我写一个 Python 函数来计算两个数的最大公约数
```

祝您使用愉快！

## 故障排查

### npm 全局安装权限问题

在执行 `npm install -g` 命令时，您可能会遇到 `EACCES` 权限错误。这是因为 npm 的全局安装目录在默认情况下需要管理员权限。

为了解决这个问题，您可以将相关目录的所有权变更为您当前的用户，这样就可以免去每次全局安装都需要输入 `sudo` 的麻烦。

在终端中运行以下命令：

```bash
sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin
```

执行完毕后，再次尝试运行 `npm install -g` 命令即可。

### 配置文件路径问题

如果 Codex 无法读取配置文件，请确保：

1. 配置文件路径正确：`~/.codex/config.toml`
2. 配置文件格式正确，特别注意 TOML 格式要求根键必须在表之前
3. 文件权限正确，确保当前用户有读取权限

### API Key 问题

如果遇到认证失败，请检查：

1. 环境变量是否正确设置：`echo $OPENAI_API_KEY`
2. API Key 是否有效且未过期
3. 是否正确执行了 `source` 命令重新加载环境变量

### Windows 环境变量不生效

如果在 Windows 上配置后报认证失败或提示找不到 API Key，多半是环境变量没真正生效：

1. 确认用的是 `setx`，而不是 `export`（PowerShell 不认 `export`）或 `$env:OPENAI_API_KEY="..."`（只对当前窗口生效）。
2. `setx` 设置后**必须关闭并重新打开终端**，老窗口读不到新值。
3. 在新终端里执行 `echo $env:OPENAI_API_KEY`，确认能正确打印出您的 Key。