OpenCode

OpenCode は、ターミナル UI、CLI、IDE 拡張、デスクトップアプリとして利用できるオープンソースの AI コーディングエージェントです。ai& は OpenCode に組み込みの provider として含まれているため、API キーで接続すれば ai& のモデルが model picker に表示されます。

ノート

コーディングエージェント用途では、カタログ から tool_calling 対応モデルを選んでください。以下の例では moonshotai/kimi-k3 を使用しています。

1. OpenCode をインストール

ターミナルまたは one-shot CLI で使う場合:

macOS / Linux

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

npm や Homebrew でもインストールできます:

npm install -g opencode-ai
brew install anomalyco/tap/opencode

Windows

ターミナルで使う場合、OpenCode は WSL を推奨しています。Windows パッケージも利用できます:

choco install opencode

または:

scoop install opencode

デスクトップアプリは、opencode.ai/download から OpenCode Desktop をダウンロードするか、パッケージマネージャーでインストールします:

macOS

brew install --cask opencode-desktop

Windows

scoop bucket add extras
scoop install extras/opencode-desktop

2. ai& に接続

ai& console で API キーを作成し、使用する環境に合わせて OpenCode に追加します。

ターミナル

OpenCode TUI で以下を実行します:

/connect

provider 一覧から ai& を選び、sk-... キーを貼り付けます。OpenCode が認証情報を保存し、以降のセッションで再利用します。

TUI の外では、shell から opencode auth login を実行すると同じ provider 一覧から選べます。

Desktop app

Settings → Providers → View all providers を開き、ai& を検索して sk-... キーを貼り付けます。Providers 画面には既定で接続済みと人気の provider しか表示されないため、全一覧を開くまで ai& は表示されません。

環境変数

CI、script、非対話実行では環境変数も使えます:

macOS / Linux

export AIAND_API_KEY="sk-your-aiand-api-key"

Windows (PowerShell)

$env:AIAND_API_KEY = "sk-your-aiand-api-key"

注意

環境変数は、AIAND_API_KEY を export 済みの shell から Desktop app を起動した場合にのみ反映されます。アプリアイコンをダブルクリックして起動した場合は読み込まれないため、代わりに Settings → Providers → View all providers → ai& からキーを追加してください。

3. モデルを選ぶ

model picker を開き、ai& セクションからモデルを選びます:

/models

モデル名は aiand/<model-id> 形式です(例: aiand/moonshotai/kimi-k3)。OpenCode は provider catalog を自動で取得するため、ai& に新しいモデルが追加されると、再インストールなしで再起動後に表示されます。

4. OpenCode を実行

対話型の terminal UI:

opencode

One-shot CLI:

opencode run "say hi in one word"

Desktop App

Desktop app もターミナルと同じ組み込みの ai& provider を使います:

1. opencode.ai/download から OpenCode Desktop をインストールする。
2. Settings → Providers → View all providers を開き、ai& を検索して API キーを貼り付ける。
3. project folder を開く。
4. /models で aiand/... モデルを選ぶ。

動作確認

OpenCode が ai& に接続できるか確認します:

opencode run -m aiand/moonshotai/kimi-k3 "reply with only: ok"

キーを ai& に直接送って確認することもできます:

macOS / Linux

curl -sS https://api.aiand.com/v1/models \
  -H "Authorization: Bearer $AIAND_API_KEY"

Windows (PowerShell)

Invoke-RestMethod https://api.aiand.com/v1/models `
  -Headers @{ Authorization = "Bearer $env:AIAND_API_KEY" }

トラブルシューティング

• provider 一覧に ai& が表示されない — OpenCode を最新版に更新して再起動し、provider catalog を再取得してください。
• ai& カタログにあるモデルが /models に表示されない — models.dev の掲載は ai& カタログ より遅れることがあります。OpenCode を再起動し、それでも表示されない場合は opencode run -m aiand/<model-id> でモデル ID を直接指定してください。
• Unauthorized request — /connect または opencode auth login(ターミナル)、あるいは Settings → Providers → View all providers → ai&(Desktop)でキーを再入力するか、OpenCode を起動している process に AIAND_API_KEY が設定されているか確認してください。
• Desktop app がキーを認識しない — Settings → Providers → View all providers → ai& からキーを追加するか、AIAND_API_KEY を export した shell から Desktop を起動してください。