Skip to Content
aicentos

OpenCode

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 です。

  • macOS / Windows:LTS バージョンをダウンロードしてインストール
  • Linux:そのページに記載のディストリビューションごとの方法でインストール

macOS に Homebrew がすでに入っていれば、次を直接実行することもできます:

brew install node

これで Node.js と npm が同時にインストールされます。

選択したインストール方法に応じて、対応するコマンドが使えるか先に確認しておくことをおすすめします。たとえば npm 方式なら次をチェックします:

node -v
npm -v

注意: Windows でコマンドライン環境を使う場合、公式は現時点で WSL の使用を推奨しています。

インストール

OpenCode 公式サイトが提供するインストールコマンドをそのまま使うのがおすすめです:

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

OpenCode 公式サイトでは npm、bun、brew などのインストール方法も提供されています。

API Key の設定

OpenCode 独自の接続・認証方式を使います:

opencode auth login

または対話インターフェースで /connect を実行し、このサービスをカスタム provider として保存します。

環境変数のほうが好みの場合は、opencode.json に公式の汎用変数名を読ませるだけで OK です。たとえば:

export OPENAI_API_KEY="your_api_key_here"

opencode.json の設定

プロジェクトルートまたはグローバル設定ディレクトリに opencode.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)
  • /v1/responses を使う場合は、OpenCode 公式ドキュメントの推奨に従い @ai-sdk/openai を使用します
  • 接続先が /v1/chat/completions のみに対応している場合にだけ、@ai-sdk/openai-compatible に変更します
  • CODEX_PROXY_API_KEY のようなプロジェクト固有の変数を追加で定義する必要はありません

関連リンク