OpenCode

概要

種類: コーディングツール主要パス: OpenAI 互換サポートレベル: サポート済みパス

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

インストール

インストールスクリプト
Homebrew
Go

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

brew install opencode-ai/tap/opencode

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

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

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

opencode --version

設定

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

export OPENAI_API_KEY="sk-your-tokenlab-key"

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

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

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

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

{
  "$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"
}

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

基本的な使い方

対話モードを開始する:

opencode

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

opencode "Explain this codebase"

モデルを指定する:

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`	アルゴリズム設計

よく使うコマンド

コードを解析する:

opencode "What does this function do?" < src/utils.ts

コードを生成する:

opencode "Create a REST API with Express"

変更をレビューする:

git diff | opencode "Review these changes"

エラーを修正する:

opencode "Fix the TypeScript errors in this project"

対話コマンド

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

トラブルシューティング

接続エラー

options.baseURL が https://api.tokenlab.sh/v1 に設定されていることを確認してください
ネットワーク接続を確認してください
テストとして curl https://api.tokenlab.sh/v1/models を試してください

認証に失敗しました

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

モデルが見つかりません

設定内のモデル名が完全に一致していることを確認してください
tokenlab.sh/en/models でモデルの利用可否を確認してください

ベストプラクティス

プロジェクトコンテキストを使用する

コードベースをより正確に理解させるために、プロジェクトのルートから OpenCode を実行してください。

適切なモデルを選択する

簡単なタスクには高速なモデル（gpt-5-mini）を使用し、複雑なタスクにはより高性能なモデル（gpt-5.4、claude-sonnet-4-6）を使用してください。

生成されたコードをレビューする

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

互換性マトリクス

コーディングツール

ネイティブ SDK

フレームワークとプラットフォーム

チャットアプリ

概要

インストール

設定

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

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

基本的な使い方

利用可能なモデル

よく使うコマンド

対話コマンド

トラブルシューティング

ベストプラクティス

​概要

​インストール

​設定

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

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

​基本的な使い方

​利用可能なモデル

​よく使うコマンド

​対話コマンド

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

​ベストプラクティス

概要

インストール

設定

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

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

基本的な使い方

利用可能なモデル

よく使うコマンド

対話コマンド

トラブルシューティング

ベストプラクティス