AruHub 文档

主题

Codex CLI 配置 ​

Codex CLI 适合在命令行里完成编码、调试和任务执行的人。它通过环境变量读取 OpenAI Compatible 接入配置，可以连接 AruHub 中兼容 OpenAI Chat / Responses 接口格式的模型。按下面步骤配置，通常几分钟就能完成第一次测试。

开始前准备 ​

开始前准备

  1. 已注册并登录 AruHub；
  2. 已在「我的密钥」创建 API Key；
  3. 已安装 Codex CLI；
  4. 知道自己当前使用的是 Windows PowerShell，还是 macOS / Linux 终端；
  5. 已在「模型广场」确认可用模型名称。

安全提示

API Key 只能保存在自己的电脑或可信服务器中，不要发送到群聊、截图或提交到 Git 仓库。

配置步骤 ​

第 1 步：确认 Codex CLI 已安装且能启动 ​

执行位置：你平时使用 Codex CLI 的终端窗口。
先确认 codex 命令本身能启动；如果系统提示找不到命令，先完成 Codex CLI 安装，再继续配置 AruHub。

text
codex

成功后你会看到：Codex CLI 能正常启动或进入交互界面，而不是提示“找不到命令”。

第 2 步：先明确这不是官方 ChatGPT / Codex 账号登录 ​

执行位置：开始配置前先看清这一点。
这里配置的是 AruHub 的 API 接口，不是去登录 ChatGPT 或 Codex 官方账号。你真正要填的是 AruHub 的 API 地址和 AruHub 的 API Key。

text
OPENAI_BASE_URL = https://api.aruhub.com/v1
OPENAI_API_KEY = sk-你的密钥

必须替换：真正配置时，把 sk-你的密钥 换成你自己的 AruHub API Key。
成功后你会看到：后面的每一步都围绕这两个环境变量展开，而不是跳去官方账号登录流程。

第 3 步：填写实际 OpenAI Compatible 接入地址 ​

执行位置：当前终端窗口。
先把 AruHub 的 Base URL 写进当前终端；如果你希望下次打开终端还能继续用，再一并写入长期配置。

powershell
$env:OPENAI_BASE_URL = "https://api.aruhub.com/v1"
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.aruhub.com/v1", "User")
bash
export OPENAI_BASE_URL="https://api.aruhub.com/v1"
echo 'export OPENAI_BASE_URL="https://api.aruhub.com/v1"' >> ~/.bashrc
# 如果你平时使用 zsh，请把 ~/.bashrc 改成 ~/.zshrc

成功后你会看到：当前窗口已经知道要把 OpenAI Compatible 请求发到 AruHub，而不是默认地址。

第 4 步：设置 API Key ​

执行位置：同一个终端窗口。
把你在 AruHub「我的密钥」创建的 API Key 写进当前终端；如果要长期使用，也一并写入长期配置。
必须替换：把 sk-你的密钥 换成你自己的真实 Key。

powershell
$env:OPENAI_API_KEY = "sk-你的密钥"
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的密钥", "User")
bash
export OPENAI_API_KEY="sk-你的密钥"
echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.bashrc
# 如果你平时使用 zsh，请把 ~/.bashrc 改成 ~/.zshrc

成功后你会看到：当前终端和之后的新终端都能读取到你的 AruHub API Key。
补充说明：如果你刚写完长期配置，Windows 请重新打开终端，或在当前窗口重新设置一次 $env:OPENAI_API_KEY；macOS / Linux 请执行 source ~/.bashrc，如果你用的是 zsh 就改成 source ~/.zshrc。

第 5 步：模型名称从 AruHub「模型广场」复制 ​

执行位置：AruHub 控制台与接下来准备启动 Codex CLI 的终端。
先去「模型广场」复制完整模型名称，不要自己手写简称，也不要只写平台名。Codex CLI 这里需要的是 AruHub 上真实可用、兼容 OpenAI Chat / Responses 的模型名称。

text
模型名称请直接从 AruHub 模型广场复制完整名称

必须替换：后续真正使用时，把这行说明替换成你从模型广场复制到的完整模型名称。
成功后你会看到：你手里已经有一个可以直接粘贴到 Codex CLI 使用位置的真实模型名。

第 6 步：启动 Codex CLI ​

执行位置：已经完成环境变量配置的终端窗口。
启动 Codex CLI，并准备使用刚才确认好的模型。

text
codex

成功后你会看到：Codex CLI 正常进入交互界面。
补充说明：如果此时它仍提示你去走官方账号登录，而不是直接使用你配置的 API 环境变量，请先返回检查 OPENAI_BASE_URL 和 OPENAI_API_KEY 是否已经在当前终端生效。

第 7 步：发送测试消息 ​

执行位置：Codex CLI 的交互界面里。
先发一条最简单的消息，确认基础连接正常。

text
回复 OK

成功后你会看到：Codex CLI 能正常返回内容，而不是停在报错、无响应或官方登录提示上。

第 8 步：到 AruHub「用量记录」确认产生了真实调用 ​

执行位置：AruHub 控制台。
打开 AruHub 的「用量记录」，确认刚才那次 Codex CLI 调用已经留下真实记录。

text
AruHub 控制台 → 用量记录

成功后你会看到：出现一条刚刚产生的新调用记录，说明 Key、Base URL 和模型名称都已经正确生效。

配置完成后，先这样确认 ​

  1. 在客户端发送：回复 OK
  2. 能正常返回内容，说明基础连接成功；
  3. 打开 AruHub 的「用量记录」；
  4. 看到刚刚产生的新调用记录，说明 Key、地址和模型名称已正确配置。

TIP

如果没有调用记录，优先检查 API Key 是否复制完整、Base URL 是否正确、模型名称是否来自模型广场。

常见问题 ​

API Key 无效或没有复制完整 ​

最常见的原因是复制时漏了一部分内容、前后多了空格，或者把示例里的 sk-你的密钥 原样保留了。请回到 AruHub 的「我的密钥」，重新复制一次，再把当前终端中的变量重新设置一遍。

Base URL 多写或少写路径 ​

这篇教程使用的真实地址是：https://api.aruhub.com/v1。如果你写成其他路径，或者漏掉了 /v1，Codex CLI 可能不会连到 AruHub。

模型名称不存在或当前不可用 ​

Codex CLI 这里不要自己猜模型名。请到 AruHub「模型广场」复制完整模型名称，并确认该模型兼容 OpenAI Chat / Responses 协议。

Windows PowerShell 和 macOS / Linux 命令混用了 ​

PowerShell 使用的是 $env:... 语法；macOS / Linux 终端使用的是 export ...。如果你把两种命令混在一起执行，环境变量通常不会按预期生效。

写入长期配置后没有重新打开终端或加载配置 ​

长期配置写入后，如果你仍在使用旧终端窗口，Codex CLI 可能还读不到新值。Windows 请重新打开 PowerShell；macOS / Linux 请执行 source ~/.bashrc，如果你使用的是 zsh，就改成 source ~/.zshrc。

客户端仍走官方地址，没有使用 AruHub 配置 ​

如果启动后仍像走默认地址，先回到当前终端检查 OPENAI_BASE_URL 和 OPENAI_API_KEY 是否已经在当前会话里生效，再重新启动 codex。

用量记录没有出现时应该查看什么 ​

先按顺序检查三件事：

  1. API Key 是否复制完整；
  2. Base URL 是否仍是 https://api.aruhub.com/v1；
  3. 模型名称是否来自模型广场，并且是 OpenAI Compatible 模型。

如果以上都没有问题，再前往 错误排查 页面继续检查。

AruHub · 统一 API 网关

Copyright © 2026 AruHub