GetAPI.ONE

为 GetAPI.ONE 配置 Codex CLI

从官方来源安装 Codex CLI，把 ONE 密钥保存在环境变量中，配置兼容 Responses 的自定义 Provider，并验证当前连接。

适用范围与准备工作

本指南只覆盖终端中的 Codex CLI，不代表所有桌面客户端、IDE 插件、模型或 Codex 功能都兼容。

一个有可用余额或适用套餐的 GetAPI.ONE 账号。
一个已私密保存、有名称且受限的 GetAPI.ONE 密钥。
从当前目录中选择一个明确列出 Responses 端点的模型。
具有安装 Codex CLI 和编辑用户级 Codex 配置的权限。

1. 安装并确认 Codex CLI

请在当前官方 Codex CLI 页面选择与你的操作系统匹配的安装方式。2026-09-07 核验的官方 macOS/Linux 独立安装命令如下。Windows 用户应按官方页面的 Windows 标签操作，不要盲目执行 Unix shell 命令。

官方 macOS / Linux 安装命令

curl -fsSL https://chatgpt.com/codex/install.sh | sh

确认命令已安装

codex --version

2. 在终端中加载密钥

启动 Codex 前，在当前 shell 中设置密钥。以下示例明确使用占位值。

macOS / Linux shell

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

PowerShell 当前进程

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. 配置 ONE Provider

打开用户级 Codex config.toml（通常位于用户的 .codex 目录），加入下面的 Provider。把 YOUR_RESPONSES_MODEL 替换为当前 GetAPI.ONE 目录中明确声明 Responses 端点的模型。

用户级 config.toml

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. 运行并验证

如果把环境变量设置为持久变量，请新开终端；否则继续使用已设置变量的当前终端。
进入项目目录并运行 codex，确认显示的 Provider/模型与预期配置一致。
只有在接受可能产生计费时，才发送一条最小提示词。
成功检查必须同时有有效 CLI 回复和 GetAPI.ONE 控制台中的对应请求/使用记录。制作本指南时未发起模型调用。

按顺序排查

现象	检查项
codex: command not found	重新查看对应系统的官方安装方式，并确认安装目录已加入 PATH。
Missing API key	确认启动 Codex 的同一环境中存在 GETAPI_ONE_API_KEY，且 env_key 拼写完全一致。
401 / Unauthorized	重新复制 ONE 密钥，确认已启用，并核对它与 https://www.getapi.one/v1 配套。
404 / 路径不兼容	确认 base_url 保留 /v1，并确认网关声明 /v1/responses。
Model not found	把占位值替换为密钥分组可见、且标记支持 Responses 端点的准确目录名称。
配置未生效	确认编辑的是 Codex 实际加载的用户级文件，model_provider 指向 getapi_one，并已重启终端/客户端。