Api Halo 文档中心

Codex CLI 接入 Api Halo 教程

安装 OpenAI Codex CLI,并通过 Api Halo 的 OpenAI 兼容接口配置模型、令牌和 Base URL。

发布与更新:2026-07-12 · 中文技术教程

安装 Codex CLI

Codex CLI 是 OpenAI 提供的终端编程工具。建议使用官方 npm 包安装,并以官方仓库说明为准。

npm install -g @openai/codex

Codex 官方 GitHub →

准备 Api Halo 令牌

  1. 登录 Api Halo 并创建独立令牌。
  2. 选择包含目标 GPT 模型的分组。
  3. 从模型广场复制准确模型名称。
OpenAI 兼容地址:https://apihalo.cn/v1

配置环境变量

export OPENAI_API_KEY="你的_API_KEY"
export OPENAI_BASE_URL="https://apihalo.cn/v1"

不同 Codex 版本的配置字段可能变化;如环境变量未生效,应核对当前版本官方配置说明,并完全重启终端。

验证调用

  1. 新开终端启动 Codex。
  2. 发送一个最小代码问题。
  3. 确认终端获得正常回复。
  4. 在 Api Halo 控制台日志中确认成功状态和模型名称。

常见问题

为什么仍请求官方地址?

检查 Base URL 变量是否被 shell 配置或旧进程覆盖。

为什么模型不可用?

检查令牌分组与模型名,不要自行猜测或缩写内部别名。

配套在线工具

按本教程确认安装方式后,带入对应软件生成配置,再执行一次最小连接测试。