> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> TokenLab API を使用するように OpenCode を設定する

## 概要

<Note>
  **種類**: コーディングツール

  **主要パス**: OpenAI 互換

  **サポートレベル**: サポート済みパス
</Note>

OpenCode は、ターミナルで動作するオープンソースの AI コーディングアシスタントです。複数の LLM プロバイダーをサポートしており、TokenLab の API を使用するように設定することで、300 以上のモデルにアクセスできます。

## インストール

<Tabs>
  <Tab title="インストールスクリプト">
    ```bash theme={null}
    curl -fsSL https://opencode.ai/install | bash
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install opencode-ai/tap/opencode
    ```

    またはコミュニティ tap を使用します（より頻繁に更新されます）:

    ```bash theme={null}
    brew install anomalyco/tap/opencode
    ```
  </Tab>

  <Tab title="Go">
    ```bash theme={null}
    go install github.com/opencode-ai/opencode@latest
    ```
  </Tab>
</Tabs>

インストールを確認します:

```bash theme={null}
opencode --version
```

## 設定

### ステップ 1: 環境変数を設定する

```bash theme={null}
export OPENAI_API_KEY="sk-your-tokenlab-key"
```

永続的に設定するには、`~/.bashrc` または `~/.zshrc` に追加します:

```bash theme={null}
echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc
```

### ステップ 2: OpenCode を設定する

OpenCode の現在のドキュメントでは、`opencode.json` または `opencode.jsonc` を通じてプロバイダーを設定することが推奨されています。TokenLab では、組み込みの `openai` プロバイダーを流用するのではなく、カスタムプロバイダーを使用してください:

```jsonc theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}
```

<Note>
  チャット補完形式との互換性には `@ai-sdk/openai-compatible` を使用してください。`/v1/responses` 上に構築されたプロバイダーパスが特に必要な場合は、OpenCode のプロバイダードキュメントではパッケージを `@ai-sdk/openai` に切り替えることが推奨されています。
</Note>

## 基本的な使い方

**対話モードを開始する:**

```bash theme={null}
opencode
```

**プロンプトを指定して実行する:**

```bash theme={null}
opencode "Explain this codebase"
```

**モデルを指定する:**

```bash theme={null}
opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"
```

## 利用可能なモデル

| モデル                 | 最適用途              |
| ------------------- | ----------------- |
| `gpt-5.4`           | 複雑なタスク、コードアーキテクチャ |
| `gpt-5-mini`        | 素早い修正、簡単な問い合わせ    |
| `claude-sonnet-4-6` | コードレビュー、ドキュメント作成  |
| `claude-opus-4-6`   | 複雑な推論             |
| `gemini-3.5-flash`  | 高速な応答             |
| `deepseek-r1`       | アルゴリズム設計          |

## よく使うコマンド

**コードを解析する:**

```bash theme={null}
opencode "What does this function do?" < src/utils.ts
```

**コードを生成する:**

```bash theme={null}
opencode "Create a REST API with Express"
```

**変更をレビューする:**

```bash theme={null}
git diff | opencode "Review these changes"
```

**エラーを修正する:**

```bash theme={null}
opencode "Fix the TypeScript errors in this project"
```

## 対話コマンド

| コマンド            | 説明             |
| --------------- | -------------- |
| `/help`         | 利用可能なコマンドを表示   |
| `/model <name>` | 別のモデルに切り替える    |
| `/clear`        | 会話履歴をクリアする     |
| `/exit`         | OpenCode を終了する |

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

<AccordionGroup>
  <Accordion title="接続エラー">
    * `options.baseURL` が `https://api.tokenlab.sh/v1` に設定されていることを確認してください
    * ネットワーク接続を確認してください
    * テストとして `curl https://api.tokenlab.sh/v1/models` を試してください
  </Accordion>

  <Accordion title="認証に失敗しました">
    * `OPENAI_API_KEY` 環境変数が設定されていることを確認してください
    * `options.apiKey` が `{env:OPENAI_API_KEY}` または別の有効な secret ソースを参照していることを確認してください
    * キーが `sk-` で始まっていることを確認してください
    * TokenLab ダッシュボードでキーが有効になっていることを確認してください
  </Accordion>

  <Accordion title="モデルが見つかりません">
    * 設定内のモデル名が完全に一致していることを確認してください
    * [tokenlab.sh/en/models](https://tokenlab.sh/ja/models) でモデルの利用可否を確認してください
  </Accordion>
</AccordionGroup>

## ベストプラクティス

<AccordionGroup>
  <Accordion title="プロジェクトコンテキストを使用する">
    コードベースをより正確に理解させるために、プロジェクトのルートから OpenCode を実行してください。
  </Accordion>

  <Accordion title="適切なモデルを選択する">
    簡単なタスクには高速なモデル（`gpt-5-mini`）を使用し、複雑なタスクにはより高性能なモデル（`gpt-5.4`、`claude-sonnet-4-6`）を使用してください。
  </Accordion>

  <Accordion title="生成されたコードをレビューする">
    プロジェクトに変更を適用する前に、AI が生成したコードを必ずレビューしてください。
  </Accordion>
</AccordionGroup>