logo

quickActions

如何使用自带API Key运行OpenAI Codex CLI

使用 Zeabur AI Hub 解锁 Codex CLI 的潜力

Kyle ChungKyle Chung

Codex CLI 是一个在终端与 AI 交互的强大接口。然而，把自己锁定在单一提供商身上会限制你的潜力。

通过将 Codex CLI 连接到 Zeabur AI Hub，你可以使用完全相同的工具将查询路由到任何顶级模型（如 Claude、Grok 或 Gemini）。此设置采用按量付费（pay-as-you-go）模式——无需为不同的 AI 提供商管理多个订阅。

以下是设置方法。

🧱 先决条件

  1. 安装 Codex CLI:

    npm install -g @openai/codex

  2. Zeabur 凭证:

    • 前往你的 Zeabur 控制台获取 AI Hub API Key。

  3. 选择你的节点 (Endpoint)

    Zeabur 目前提供两个节点。请选择地理位置离你最近的一个：

    • 亚洲 (东京): https://hnd1.aihub.zeabur.ai/
    • 美西 (旧金山): https://sfo1.aihub.zeabur.ai/

⚙️ 快速设置指南

你需要配置 Codex 与 Zeabur 的统一 API 进行通信，而不是直接连接特定的提供商。

1. 创建配置文件

创建或编辑位于 ~/.codex/config.toml 的配置文件。粘贴以下配置以将 Zeabur 定义为提供商：

# 默认使用的模型
model = "gemini-3-pro-preview"
model_provider = "zeabur"

[model_providers.zeabur]
name = "Zeabur AI Hub"
# 注意：确保在 endpoint 后添加 /v1
base_url = "<https://hnd1.aihub.zeabur.ai/v1>"
env_key = "ZEABUR_API_KEY"
wire_api = "chat"

2. 设置 API Key

你需要让工具能够读取你的 API Key。

选项 A: 仅作尝试 (临时)

用于单次会话：

export ZEABUR_API_KEY="你的-zeabur-api-key"
codex "Who are you?"

选项 B: 一劳永逸 (永久)

为了避免每次都设置 Key，请将其添加到你的 Shell 配置文件中。

  1. 打开你的 Shell 配置（例如 ~/.zshrc 或 ~/.bashrc）：

    nano ~/.zshrc

  2. 在底部粘贴此行：

    export ZEABUR_API_KEY="你的-zeabur-api-key"

  3. 保存并重载：source ~/.zshrc

💸 开始编码 (使用任何模型)

现在你可以使用该 CLI 工具，并灵活地随时切换模型。

基本用法:

codex "Write a hello world function in Python"

切换模型:

你可以使用 -m 标志覆盖配置中定义的默认模型。

# 使用 Gemini
codex -m gemini-3-pro-preview "hi"

# 使用 Claude
codex -m claude-sonnet-4-20250514 "hi"

# 使用 GPT-4o
codex -m gpt-4o "hi"

优势所在:

  • 灵活性: 无需更改工具即可在 Grok、Claude 和 GPT 之间切换。
  • 成本效益: 通过 Zeabur 仅为你使用的 Token 付费，而不是为多个 AI 订阅支付固定的月费。

🔧 故障排除

如果你遇到问题：

  • 401 Unauthorized:
    • 检查配置中的 base_url 是否包含 /v1。
    • 验证环境变量是否已设置：echo $ZEABUR_API_KEY。
  • Model Not Found:
    • 确保模型名称（例如 gpt-4o）目前受 Zeabur AI Hub 支持。请查看 Zeabur 控制台以获取可用模型 ID 的列表。

Happy Coding!

return Blogs