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

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

<AIHubShutdownNotice />


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

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

以下是设置方法。

## 🧱 先决条件

1. **安装 Codex CLI**:
    
    ```bash
    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 定义为提供商：

```toml
# 默认使用的模型
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: 仅作尝试 (临时)**

用于单次会话：

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

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

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

1. 打开你的 Shell 配置（例如 `~/.zshrc` 或 `~/.bashrc`）：
    
    ```bash
    nano ~/.zshrc
    ```
    
2. 在底部粘贴此行：
    
    ```bash
    export ZEABUR_API_KEY="你的-zeabur-api-key"
    ```
    
3. 保存并重载：`source ~/.zshrc`

---

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

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

**基本用法:**

```bash
codex "Write a hello world function in Python"
```

**切换模型:**

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

```bash
# 使用 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!