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 提供商管理多个订阅。

Explore AI Models on Zeabur AI Hub

Access leading AI models with transparent pricing on Zeabur AI Hub.

View ModelsClaude, Gemini, GPT, and more available.

以下是设置方法。

🧱 先决条件

  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 订阅支付固定的月费。
Explore AI Models on Zeabur AI Hub

Access leading AI models with transparent pricing on Zeabur AI Hub.

View ModelsClaude, Gemini, GPT, and more available.

🔧 故障排除

如果你遇到问题：

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

      Access leading AI models with transparent pricing on Zeabur AI Hub.

      View ModelsClaude, Gemini, GPT, and more available.

控制台以获取可用模型 ID 的列表。

Happy Coding!

return Blogs