# OpenCode

出典: https://docs.aicentos.com/ja/clients/opencode

Language: ja

> 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 に公式の汎用変数名を読ませるだけで OK です。たとえば：

```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 配下のモデルが表示されれば OK です。

## 注意事項

* 推奨の順序：まず設定ファイル（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/)