コーディングツール
OpenCode
TokenLab APIを使用するためのOpenCodeの設定
エージェントに設定を任せる
以下のタスクを、コンピュータ上で実行中のエージェントにコピーしてください:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/ja/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.概要
OpenCodeは、カスタムのOpenAI互換プロバイダーを通じてTokenLabを使用できます。TokenLabのAPIキー、Base URL、および現在のモデルIDを追加してください。
インストール
npm install -g opencode-ai@1.18.31インストールの確認:
opencode --version設定
ステップ 1: 環境変数の設定
クイックスタートのターミナル手順(macOS、Linux、WSL、またはWindows PowerShell用)を使用して、コマンド履歴にキーを残さずに TOKENLAB_API_KEY を設定します。そのターミナルからOpenCodeを起動してください。永続的に使用する場合は、ローカルのシークレットマネージャーを使用してください。シェルプロファイルにプレーンテキストのキーを追記しないでください。
ステップ 2: OpenCodeの設定
以下の設定は OpenCode 1.18.31 で確認済みです。他のバージョンについては、公式ドキュメントを参照して各自で検証する必要があります。
以下の設定内容で、個別の ~/.config/opencode/tokenlab.jsonc ファイルを作成します。XDG_CONFIG_HOME が設定されている場合は、そのディレクトリ配下の opencode/tokenlab.jsonc を使用してください。通常の opencode.json / opencode.jsonc、アカウント、デフォルトモデル、権限設定は変更しないでください。この個別のファイルは、OPENCODE_CONFIG で指定して呼び出した場合にのみ読み込まれます。ファイル名やプロバイダー名が他の設定と重複している場合は、別のファイル名や名前を選択し、コマンドを調整してください。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"tokenlab": {
"npm": "@ai-sdk/openai-compatible",
"name": "TokenLab",
"options": {
"baseURL": "https://api.tokenlab.sh/v1",
"apiKey": "{env:TOKENLAB_API_KEY}"
},
"models": {
"gpt-5.6-terra": {
"name": "GPT-5.6 Terra"
},
"gpt-5.6-luna": {
"name": "GPT-5.6 Luna"
}
}
}
}
}この設定では、Chat Completionsのために @ai-sdk/openai-compatible を使用しています。Chat Completionsおよび必要なツールをサポートしている現在のモデルを選択してください。この例から、他のプロトコルやバージョンのサポートを推測しないでください。
オプションとして、リバーシブルなOpenCodeセットアップヘルパーを使用すると、Python 3.11+環境でプレビュー、適用、および元のファイルへの復元が可能になります。TokenLab Skillsプラグイン 0.1.2 にはこれらのスクリプトが含まれています。スタンドアロンのSkillインストールでも、それらを含むバージョンに更新した後に使用可能です。既存のプラグインまたはスタンドアロンのSkillインストールについては、READMEの更新手順に従い、スクリプトが存在することを確認してください。ここでの手動設定は、ヘルパーなしでも使用可能です。
基本的な使用方法
クイックスタートを使用してキーを設定し、このファイルを読み込んで、呼び出し時にモデルを明示的に選択します。カスタマイズしている場合は、実際のパスとプロバイダー名に置き換えてください。既存の OPENCODE_CONFIG やインラインの OPENCODE_CONFIG_CONTENT 設定は、別の起動環境で保持してください。プロジェクト設定や管理設定が優先される場合があります。
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terraモデルの検出はローカルでの読み込みを確認するものであり、キーの有効性やライブリクエストの成功を保証するものではありません。プロンプトはTokenLabの残高を消費し、OpenCodeはタイトル生成などの個別に課金される補助的なリクエストを送信する場合があります。返信内容と、対応するリクエスト記録を確認してください。
通常の設定を使用する場合は、このレイヤーなしで起動してください。このガイドのために OPENCODE_CONFIG をシェルプロファイルに永続化しないでください。手動設定を取り消すには、作成した個別のファイルを削除するか、以前に存在していた場合はバックアップから復元してください。
同じエージェントで画像と動画を生成する
OpenCodeは、TokenLab MCPサーバーを使用して画像や短い動画を作成することもできます。各生成は同じTokenLab残高から支払われます。この mcp エントリを、provider の隣にある同じ tokenlab.jsonc にマージしてください。OpenCodeは {env:TOKENLAB_API_KEY} をターミナルの変数に置き換えるため、キーがファイルに書き込まれることはありません:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}timeout を長めに設定することで、初回起動時に npx がパッケージをダウンロードする時間を確保します。同じ OPENCODE_CONFIG を使用して opencode mcp list を実行し、tokenlab が接続されていることを確認してください。その後、以下を試してください:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video はタスクIDを返します。エージェントは動画の準備ができるまで get_task_status を呼び出します。その他の設定については、OpenCode MCPサーバーを参照してください。
モデルの選択
モデルページから現在のコーディングモデルIDをコピーしてください。デフォルトを設定する前に、自身のレポジトリでモデルを比較してください。
一般的なコマンド
コードの分析:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.tsコードの生成:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"変更のレビュー:
git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"エラーの修正:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"インタラクティブコマンド
| コマンド | 説明 |
|---|---|
/help | 利用可能なコマンドを表示 |
/models | 別のモデルに切り替え |
/clear | 会話履歴をクリア |
/exit | OpenCodeを終了 |