# OpenCode

來源: https://docs.aicentos.com/zh-TW/clients/opencode

Language: zh-TW

> 在 OpenCode 中使用 aicentos —— 透過設定檔接入自訂 provider

OpenCode 支援自訂 provider，可以透過設定檔的方式接入 Codex Proxy 服務。

## 準備工作

OpenCode 官網提供官方安裝腳本，也提供 npm、bun、brew 等安裝方式。

* 如果你直接使用官方安裝腳本，通常不需要先手動設定 npm
* 如果你準備走 npm 安裝，請先安裝 Node.js 與 npm
* 如果你準備走 bun 安裝，則需要先安裝 bun

### 安裝 Node.js（npm 方式）

Node.js 官方下載頁是：[https://nodejs.org/en/download](https://nodejs.org/en/download)

* macOS / Windows：下載並安裝 LTS 版本
* Linux：依該頁面提供的發行版方式安裝

如果你在 macOS 上已經安裝了 Homebrew，也可以直接執行：

```bash
brew install node
```

這會同時安裝 Node.js 和 npm。

建議先依你選擇的安裝方式確認對應指令可用。例如 npm 方式可先檢查：

```bash
node -v
npm -v
```

**注意：** 如果你在 Windows 上使用命令列環境，官方目前建議優先在 WSL 中使用。

## 安裝

推薦直接使用 OpenCode 官網提供的安裝指令：

```bash
curl -fsSL https://opencode.ai/install | bash
```

OpenCode 官網同時提供 npm、bun、brew 等安裝方式。

## 設定 API Key

使用 OpenCode 自己的連線或驗證方式：

```bash
opencode auth login
```

或者在互動介面裡執行 /connect，把這個服務作為自訂 provider 儲存。

如果你更習慣環境變數，讓 opencode.json 讀取官方通用變數名稱即可，例如：

```bash
export OPENAI_API_KEY="your_api_key_here"
```

## 設定 opencode.json

在專案根目錄或全域設定目錄中建立 opencode.json：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}
```

## 測試

啟動 OpenCode 後，執行：

```
/models
```

看到 aicentos 下的模型即可。

## 注意事項

* 推薦順序：先手動設定檔（opencode.json），再環境變數，最後才是 cc-switch 工具（[https://github.com/farion1231/cc-switch/releases）](https://github.com/farion1231/cc-switch/releases）)
* 如果你走 /v1/responses，OpenCode 官方文件建議使用 @ai-sdk/openai
* 如果你的接入只支援 /v1/chat/completions，才改用 @ai-sdk/openai-compatible
* 不需要額外定義 CODEX\_PROXY\_API\_KEY 這類專案私有變數

## 相關連結

* 官方網站：[https://opencode.ai/](https://opencode.ai/)