在 Codex CLI 中使用 OpenVeer

详细指导如何在 Codex CLI 中配置和使用 OpenVeer API 服务，通过简单的配置即可在 Codex CLI 中调用多种 AI 模型进行辅助编程。

简介

Codex CLI 是 OpenAI 推出的开源终端编程智能体，可以在命令行中直接读写文件、运行命令、修复 Bug 并完成完整的编码任务。
通过接入 OpenVeer，您可以在 Codex CLI 中自由使用包括 GPT、Claude 在内的多种模型，并享受更灵活、更优惠的计费方式。

准备工作

在开始之前，请确保：

1. 已安装 Node.js
   从 Node.js 官网 下载并安装（建议使用最新 LTS 版本，v20 或更高），用于通过 npm 安装 Codex CLI

2. 已获取 OpenVeer API 密钥
   登录 OpenVeer 控制台 获取您的 API 密钥（以 sk- 开头）

第一步：安装 Codex CLI

选择以下任一方式安装：

npm（推荐）

使用 npm 全局安装，适用于所有操作系统：

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

<div class="callout note"><strong>注意</strong><div>如果遇到权限问题，请在命令前加 `sudo`（macOS / Linux）。</div></div>

Homebrew (macOS)

macOS 用户也可以通过 Homebrew 安装：

```bash
brew install codex
```

验证安装

安装完成后，运行以下命令确认安装成功：

codex --version

如果输出版本号，说明安装成功。

第二步：配置 OpenVeer API

Codex CLI 通过 ~/.codex/ 目录下的配置文件管理模型供应商。我们只需新增一个指向 OpenVeer 的自定义供应商即可。

2.1 找到配置目录

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

2.2 配置 API 密钥

在配置目录下创建或编辑 auth.json 文件，填入您的 OpenVeer 密钥：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

2.3 配置模型供应商

在配置目录下创建或编辑 config.toml 文件，添加 OpenVeer 供应商：

# 默认使用的模型
model = "gpt-5.5"
# 默认使用的供应商，对应下方 [model_providers.OpenVeer]
model_provider = "OpenVeer"

# OpenVeer 供应商配置
[model_providers.OpenVeer]
name = "OpenVeer"
base_url = "https://api.openveer.com/v1"
wire_api = "responses"
requires_openai_auth = true

保存两个文件后，重新启动 Codex CLI 即可生效。

第三步：开始使用

验证配置

在任意项目目录下运行以下命令，确认配置是否正确：

codex "用一句话介绍你自己"

如果收到 AI 回复，说明配置成功。如果出现登录界面或 401、403 等错误，请参考下方常见问题排查。

交互模式

直接运行 codex 进入交互式界面，适合处理完整的编码任务：

codex

进入后即可用自然语言描述需求，例如：

帮我创建一个 Express.js 服务器，包含一个返回 JSON 的健康检查接口

Codex 会自动分析项目、生成代码、运行命令，并在执行敏感操作前请求您确认。

审批模式

首次运行时，Codex 会让您选择操作审批级别：

建议从 自动 模式开始使用，在交互界面中输入 /approvals 可随时调整。

切换模型

在交互界面中输入 /model 命令即可快速切换模型，或修改 config.toml 中的 model 字段后重启。

支持的模型

在 Codex CLI 中，推荐使用以下 GPT-5 系列模型：

常用命令

以下是 Codex CLI 中常用的命令和快捷操作：

常见问题

Q1: 启动后弹出 ChatGPT 登录界面？

如果启动后显示 "Sign in with ChatGPT" 等登录提示，说明配置未生效。

排查步骤：

1. 确认 config.toml 和 auth.json 都位于 ~/.codex/ 目录下
2. 检查 config.toml 中的 model_provider 是否为 OpenVeer
3. 检查 auth.json 的 JSON 格式是否正确，密钥是否完整填入

Q2: 出现 401 / 403 错误？

同时确保 base_url 设置为 https://api.openveer.com/v1，而非 OpenAI 官方地址。

Q3: 提示连接失败？

1. 检查网络连接是否正常
2. 确认 config.toml 中的 base_url 配置正确
3. 如果使用了代理，确保代理设置允许访问 api.openveer.com

Q4: 提示 wire_api = "chat" 不再支持？

新版 Codex CLI（0.84.0 及以后）已移除 chat 协议，请将 config.toml 中的 wire_api 改为 responses：

wire_api = "responses"

OpenVeer 已提供 Responses API，修改后重新启动 Codex 即可。

Q5: 工具调用或运行报错？

确认 config.toml 中的 wire_api 设置为 responses。如果遇到兼容性问题，建议切换为推荐的 GPT-5 系列模型（如 gpt-5.5、gpt-5.3-codex），与 Codex CLI 配合更稳定。

Q6: 想使用环境变量而非 auth.json？

也可以通过环境变量配置密钥。将 config.toml 中供应商配置改为：

[model_providers.OpenVeer]
name = "OpenVeer"
base_url = "https://api.openveer.com/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"

然后设置环境变量 APIMART_API_KEY 为您的 OpenVeer 密钥即可，此时无需 auth.json。

Q7: 如何切换模型？

两种方式：

1. 交互界面中：输入 /model 命令即可切换
2. 修改配置：更改 config.toml 中的 model 字段，重启 Codex CLI

Q8: 如何查看使用情况和费用？

登录 OpenVeer 控制台 查看 API 调用统计、Token 消耗明细和费用趋势。

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 OpenVeer 文档中心
• 💬 Discord 社区
• 🐦 Twitter @OpenVeer_