CloseAI

Appearance

通过 CloseAI 使用 OpenAI Codex ​

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

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

准备工作 ​

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

  1. 一个 CloseAI 账户。
  2. 一个 CloseAI API Key。您可以在您的账户仪表板中生成和管理。
  3. 已安装 Node.js (版本需 >= 18) 和 npm。

第一步：安装 OpenAI Codex ​

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

bash
npm install -g @openai/codex

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

第二步：配置环境变量 ​

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

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

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

bash
export OPENAI_API_KEY="sk-xxxxxxxx"

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

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

第三步：创建配置文件 ​

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

bash
mkdir -p ~/.codex

然后创建配置文件 ~/.codex/config.toml，并添加以下内容：

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

toml
model = "gpt-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 命令重新加载环境变量

Copyright © 2024 CloseAI