# OpenCode

Source: https://aiand-docs-staging.pages.dev/ja/integrations/opencode/

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

<Aside type="note">
  コーディングエージェント用途では、[カタログ](/ja/models/catalog/) から `tool_calling`
  対応モデルを選んでください。以下の例では `moonshotai/kimi-k3` を使用しています。
</Aside>

## 1. OpenCode をインストール

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

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

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

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

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

</TabItem>
<TabItem label="Windows">

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

```powershell
choco install opencode
```

または:

```powershell
scoop install opencode
```

</TabItem>
</Tabs>

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

<Tabs>
<TabItem label="macOS">

```bash
brew install --cask opencode-desktop
```

</TabItem>
<TabItem label="Windows">

```powershell
scoop bucket add extras
scoop install extras/opencode-desktop
```

</TabItem>
</Tabs>

## 2. ai& に接続

[ai& console](https://console.aiand.com/api-keys) で API キーを作成し、使用する環境に合わせて OpenCode に追加します。

### ターミナル

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

```text
/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、非対話実行では環境変数も使えます:

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

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

</TabItem>
<TabItem label="Windows (PowerShell)">

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

</TabItem>
</Tabs>

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

## 3. モデルを選ぶ

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

```text
/models
```

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

## 4. OpenCode を実行

対話型の terminal UI:

```bash
opencode
```

One-shot CLI:

```bash
opencode run "say hi in one word"
```

## Desktop App

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

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

## 動作確認

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

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

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

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

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

</TabItem>
<TabItem label="Windows (PowerShell)">

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

</TabItem>
</Tabs>

## トラブルシューティング

- **provider 一覧に ai& が表示されない** — OpenCode を最新版に更新して再起動し、provider catalog を再取得してください。
- **ai& カタログにあるモデルが `/models` に表示されない** — models.dev の掲載は [ai& カタログ](/ja/models/catalog/) より遅れることがあります。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 を起動してください。