# Zeabur AI Hub + OpenCode：无需订阅的 AI 编程

> 无需订阅，按量付费。将 OpenCode 连接至 Zeabur AI Hub，在终端通过统一 API 使用 GPT-5 和 Claude 4.5。

<AIHubShutdownNotice />

想象一下，有一款像 **[Claude Code](https://zeabur.com/blogs/use-claude-code-with-ai-hub)** 一样强大的工具，能够瞬间从 **GPT-5** 切换到 **Claude Sonnet 4.5**，而无需手动管理多个订阅和 API 密钥，这会是一种怎样的体验？

[**OpenCode**](https://opencode.ai) 已成为那些渴望拥有 **GPT-5 终端编程助手** 的开发者的首选 **OpenCode CLI**。然而，要高效地配置它，需要合适的基础设施。通过集成 **Zeabur AI Hub**，开发者可以解锁灵活的“按量付费”模式，无需承担固定的月费即可访问顶级 LLM。

在本文中，我们将解释 OpenCode CLI 和 [Zeabur AI Hub](https://zeabur.com/models) 是什么，并指导您完成设置过程，获取**开发者专用的统一 LLM API 密钥**。

## 什么是 OpenCode？

![OpenCode Logo ](https://cdn.zeabur.com/opencode.png)

OpenCode 是一款开源的 AI 编程助手，旨在驻留在您的终端中。与锁定特定模型的专有工具不同，OpenCode 是**供应商中立（Provider-agnostic）**的。这允许您将编程查询路由到 OpenAI、Anthropic 或自定义端点。对于重视隐私和代码库数据控制权的开发者来说，这种灵活性使其成为首选。

## 什么是 Zeabur AI Hub？

**Zeabur** 是一个现代化的部署平台，旨在简化开发者的基础设施。**Zeabur AI Hub** 充当统一的 API 网关，将各种 LLM 提供商（如 OpenAI 和 Anthropic）聚合到一个端点中。

这种统一的基础设施非常通用——它不仅支持 OpenCode，还支持其他高级集成，如 **[Codex](https://zeabur.com/blogs/use-codex-with-ai-hub)**，确保您在所有 AI 工具中拥有通过一致的体验。

**此集成的核心优势：**

*   **Zeabur 与 OpenAI API 定价对比：** 您无需为 ChatGPT Plus 支付 $20/月，再为 Claude Pro 支付 $20/月，而是获得 **按量付费的 Claude Sonnet 4.5** 体验。您只需为实际使用的部分付费。
*   **边缘极速低延迟：** 竞争对手通常受困于路由延迟。Zeabur 在东京和旧金山使用边缘路由端点，确保您的代码补全速度显著加快。
*   **统一访问：** 停止频繁切换密钥。只需一个 API 密钥即可访问多个前沿模型。

## 分步指南：将 OpenCode 连接到 Zeabur

按照本教程操作，在 2 分钟内配置好您的环境。

### 前置条件

1.  **安装 OpenCode CLI**：
    确保您的机器上已安装该工具。
    ```bash
    npm install -g opencode
    ```

2.  **Zeabur 凭证**：
    *   前往您的 Zeabur 控制台生成您的 **AI Hub API Key**。

3.  **选择您的端点**：
    为了获得最低延迟，请选择距离您最近的端点：
    *   **亚洲 (东京):** `https://hnd1.aihub.zeabur.ai/`
    *   **美西 (旧金山):** `https://sfo1.aihub.zeabur.ai/`

---

## 如何配置 OpenCode 提供商

OpenCode 使用配置文件来管理自定义提供商。我们将添加 Zeabur 作为兼容提供商以启用模型切换。

### 1. 编辑配置文件

创建或编辑位于 `~/.config/opencode/config.json` 的 OpenCode 配置文件。

```bash
# 在您喜欢的编辑器中打开配置文件
nano ~/.config/opencode/config.json
```

粘贴以下配置。**注意：** 如果您在美洲，可以将 `baseURL` 更改为美国端点 (`sfo1`)。

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zeabur": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zeabur AI Hub",
      "options": {
        "baseURL": "https://hnd1.aihub.zeabur.ai/"
      },
      "models": {
        "claude-sonnet-4-5": {
          "name": "Claude Sonnet 4.5"
        },
        "claude-haiku-4-5": {
          "name": "GPT-5-Codex"
        },
        "gpt-5":{
            "name": "GPT 5"
        }
      }
    }
  }
}
```

保存文件并退出。

### 2. 连接 CLI

配置设置完成后，您需要使用 OpenCode CLI 进行身份验证。

1.  运行工具：
    ```bash
    opencode
    ```
2.  输入连接命令：
    ```bash
    /connect
    ```
3.  从提供商列表中选择 **Zeabur AI Hub**。
4.  在提示时粘贴您的 **Zeabur AI Hub API Key**。

---

## 🚀 开始编程

您现在已连接！您可以在最新模型之间切换，而无需更改 API 密钥。

**为什么开发者转向这种设置：**

*   **访问未发布的能力：** 瞬间将您的终端转变为 **GPT-5 终端编程助手**。
*   **成本效益：** 享受 **按量付费的 Claude Sonnet 4.5** 访问权限。如果您一周不写代码，您支付 $0。
*   **灵活性：** 在项目中期从 GPT 切换到 Claude，看看哪个模型能更快解决您的 Bug。

编程愉快！