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

# OpenCode

[OpenCode](https://opencode.ai/) は、ターミナル・IDE・デスクトップアプリを横断して動作するオープンソースのコーディングアシスタントです。LSP の自動セットアップ、複数セッションの並列実行、コラボレーションやデバッグのためのセッション共有をサポートしています。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=opencode\&utm_medium=external\&utm_campaign=cloud_signup) のアカウントと API キー
* Node.js 18 以上 (npm でインストールする場合)

## インストールとセットアップ

<Steps>
  <Step title="OpenCode のインストール">
    <Tabs>
      <Tab title="curl">
        ```bash theme={}
        curl -fsSL https://opencode.ai/install | bash
        ```
      </Tab>

      <Tab title="npm">
        ```bash theme={}
        npm install -g opencode-ai
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Web UI の起動">
    ```bash theme={}
    opencode web
    ```

    OpenCode はローカルサーバーを起動し、デフォルトのブラウザで Web UI を自動的に開きます。ターミナルに URL (例: `http://localhost:4096`) が表示されます。
  </Step>

  <Step title="カスタムプロバイダーの追加">
    **「Settings」>「Providers」** に移動し、新しいカスタムプロバイダーの追加をクリックします。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/Uu2D5xFHXnhf5KrO/images/docs/integrations/opencode/opencode1.png?fit=max&auto=format&n=Uu2D5xFHXnhf5KrO&q=85&s=1b5997725e1d6a78068ad6a09c94fd13" alt="Providers セクションが表示された OpenCode の設定画面" style={{ maxWidth:"100%" }} width="1948" height="1237" data-path="images/docs/integrations/opencode/opencode1.png" />
    </Frame>
  </Step>

  <Step title="SambaNova 認証情報の設定">
    以下の情報を入力します。

    * **URL**: `https://api.sambanova.ai/v1`
    * **API Key**: お使いの SambaCloud API キー
    * **Model Name**: 例: `MiniMax-M2.7`

    API キーは [SambaCloud ポータル](https://cloud.sambanova.ai/apis) で取得できます。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/Uu2D5xFHXnhf5KrO/images/docs/integrations/opencode/opencode2.png?fit=max&auto=format&n=Uu2D5xFHXnhf5KrO&q=85&s=c7d737d16e583b013ec50b9e1732a032" alt="SambaNova の認証情報が入力された OpenCode のプロバイダー設定フォーム" style={{ maxWidth:"100%" }} width="1416" height="1167" data-path="images/docs/integrations/opencode/opencode2.png" />
    </Frame>
  </Step>

  <Step title="SambaNova モデルの利用開始">
    これで、OpenCode のワークフローで SambaNova のモデルを使用できるようになりました。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/Uu2D5xFHXnhf5KrO/images/docs/integrations/opencode/opencode3.png?fit=max&auto=format&n=Uu2D5xFHXnhf5KrO&q=85&s=3f1a406827b6410d9adbc189aa77f231" alt="SambaNova モデルを使用している OpenCode のチャットインターフェース" style={{ maxWidth:"100%" }} width="3563" height="1732" data-path="images/docs/integrations/opencode/opencode3.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  設定完了後にモデルを追加したい場合は、`~/.config/opencode/opencode.json` ファイルの `models` キーを変更してください。

  ```json theme={}
    "models": {
      "MiniMax-M2.7": {
        "name": "MiniMax-M2.7"
      },
      "gpt-oss-120b": {
        "name": "gpt-oss-120b"
      }
    }
  ```
</Note>

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

<AccordionGroup>
  <Accordion title="「Model not found」エラー">
    OpenCode のモデル ID は `provider/model` 形式です。常に `sambanova/MiniMax-M2.7` と指定し、素のモデル ID だけを使わないでください。素の ID は、`opencode.json` の `provider.sambanova.models` 内のキーとしてのみ使用されます。
  </Accordion>

  <Accordion title="API キーが認識されない">
    `{env:SAMBANOVA_API_KEY}` は OpenCode の起動時に解決されます。シェルで変数をエクスポートし、その同じシェルセッションから OpenCode を起動してください。古い tmux ペインや、エクスポートを読み込んでいないシェルからは起動しないよう注意してください。
  </Accordion>

  <Accordion title="Web UI が開かない">
    ターミナルから `opencode web` を実行します。OpenCode は起動した URL (例: `http://localhost:4096`) を表示し、ブラウザで自動的に開きます。ポートがすでに使用されている場合は、`lsof -i :[PORT]` で別の OpenCode プロセスが動いていないか確認してください。`[PORT]` にはターミナルに表示された番号を指定します。
  </Accordion>
</AccordionGroup>

## 参考情報

* [OpenCode ドキュメント](https://opencode.ai/docs/)
* [OpenCode プロバイダー](https://opencode.ai/docs/providers/)
* [SambaCloud モデル](/docs/ja/models/sambacloud-models)
* [SambaCloud API リファレンス](/docs/ja/api-reference/overview)