無料の LLM API で OpenCode を使う
OpenCode は、ターミナルとデスクトップで使えるオープンソースのコーディングエージェントです。OpenAI 互換の任意のプロバイダを使えます。このガイドでは、FreeLLMAPI を通じて OpenCode を無料モデルに接続します。1 つのコマンドで設定を書き込み、キーを保存します。
コード、モデル名、ライブのカタログラベルは英語で表示します。
手順 1: FreeLLMAPI をインストールする
FreeLLMAPI は、オープンソースのゲートウェイです。お使いのコンピュータ上の Docker で動作し、45 社のプロバイダの無料枠を 1 つのキーにまとめます。
macOS または Linux にインストールする
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 を開きます。Keys ページで無料プロバイダのキーを 2 つ以上追加します。Google AI Studio と Groq は、それぞれ数分で無料のキーを発行します。同じページから統合キーをコピーします。
手順 2: コマンド 1 つで OpenCode を接続する
コマンド 1 つで設定する
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeこのコマンドは次の 3 つの処理を行います。
freellmapiプロバイダを~/.config/opencode/opencode.jsonに追加します。このプロバイダには、ライブのカタログにあるモデルが、それぞれのコンテキストの上限とともに一覧されます。- 既定のモデルとして
freellmapi/autoを設定します。 - キーを OpenCode の認証ファイル
~/.local/share/opencode/auth.jsonに保存します。CLI でもデスクトップアプリでも、環境変数は必要ありません。
このコマンドは、書き込みの前にバックアップを作成します。新しいプロバイダをマージするため、他のプロバイダは残ります。XDG_CONFIG_HOME または XDG_DATA_HOME が設定されている場合、コマンドはそのフォルダを使います。
長いタスクを開始する前に、ゲートウェイが今すぐリクエストに応答できることを確認します。次のコマンドは、現時点で使用可能なキーがあるモデルのみを一覧します。
準備ができているモデルを確認する
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"ステータスが exhausted のモデルにはキーがありますが、現在はすべてのキーが上限に達しています。このステータスは、クールダウンが終わると解除されます。npx freellmapi doctor を実行し、クライアントのリクエストがゲートウェイに届いていることを確認します。ダッシュボードのリクエストログには、OpenCode からの各呼び出しが表示されます。レスポンスヘッダー X-Routed-Via には、各リクエストに応答したプロバイダとモデルが表示されます。リクエストがフェイルオーバーした場合、X-Fallback-Trail ヘッダーには、失敗した各ホップと理由が表示されます。
手動設定: opencode.json のプロバイダ設定
手動で設定するには、このブロックを ~/.config/opencode/opencode.json、またはプロジェクトの opencode.json に追加します。OpenCode は、@ai-sdk/openai-compatible を /v1/chat/completions のエンドポイントに使います。
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}次にキーを追加します。OpenCode を起動し、/connect を実行して、freellmapi プロバイダを選び、統合キーを貼り付けます。/connect のプロバイダ ID は、設定の ID と一致させてください。/models を実行してモデルを選びます。
limit.contextは、モデルの最大入力トークン数です。limit.outputは、モデルが生成できる最大トークン数です。- 最上位の
modelはprovider/modelの形式を使います。これがない場合、OpenCode は以前に使っていたモデルを保持します。 - 使いたいモデル ID は、すべて
modelsの対応表に含める必要があります。GET /v1/modelsから ID を追加してください。
providers キーを持つ V2 の設定形式が説明されています。ドキュメントによると、上の V1 形式もサポートされています。FreeLLMAPI のセットアップ用コマンドは、V1 形式を書き込みます。OpenCode に向くモデルを選ぶ
OpenCode はエージェントです。ツール呼び出しを通じて、ファイルを読み、編集し、コマンドを実行します。各リクエストには、システムプロンプト、ツールの定義、ファイルの内容が含まれます。ツール呼び出しに対応し、大きなコンテキストウィンドウを持つモデルを使ってください。
| モデル | 無料で利用可能 | コンテキスト | 無料枠の上限(最良の条件) | ツール | 画像入力 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 リクエスト/分 1 req/min per model | はい | いいえ |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 リクエスト/分 40 RPM | はい | はい |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | はい | はい |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | はい | いいえ |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | はい | はい |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | はい | はい |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 リクエスト/分 50 リクエスト/日 50 req/day account-wide (1,000 after a $10 purchase) | はい | はい |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 リクエスト/分 50 リクエスト/日 Shared rate limit | はい | いいえ |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 リクエスト/分 250 リクエスト/日 70,000 トークン/分 ~6M | はい | はい |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | はい | はい |
一致する無料モデル 109 件のうち 12 件を表示しています。 すべてのモデルを見る.
FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。
freellmapi/auto を使うと、ルーターがリクエストごとにモデルを選びます。知能または速度を基準にリクエストを振り分けるには、auto:smart または auto:fast を models の対応表に追加します。ダッシュボードで作成した後は、名前付きのプロファイル (例: auto:coding) を追加することもできます。
レート制限と長いセッション
1 回のエージェントのタスクで、数十件のリクエストが送られることがあります。1 つの無料枠では、長いタスクはすぐに止まります。FreeLLMAPI は、各キーのリクエスト数とトークン数を数えます。プロバイダが 429 エラーを返すと、ルーターはチェーン内の次のモデルにリクエストを送り、セッションは継続します。
- 4 社以上のプロバイダのキーを追加します。プロバイダが多いほど、1 日あたりのリクエスト数が増えます。
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchを FreeLLMAPI の.envに設定し、コンテキストの引き継ぎをオンにします。モデルが切り替わると、次のモデルには、タスクを継続していることを示す短いメモが渡されます。- 固定セッションは、会話を 30 分間 1 つのモデルに保ちます。これにより、エージェントの動作が一貫します。
- タスクごとに新しいセッションを開始します。コンテキストが小さいほど、リクエストごとのトークン数が少なくなります。
トラブルシューティング
| 問題 | 原因 | 対処 |
|---|---|---|
| キーが有効なのに「Invalid API key」と表示される | 設定内の空の apiKey が、/connect のキーを上書きしている | apiKey を options から削除するか、setup-opencode をもう一度実行します |
| OpenCode が新しいプロバイダを使わない | 最上位の model が設定されていない | "model": "freellmapi/auto" を設定します |
| モデルが見つからない | モデル ID が、プロバイダの models 対応表にない | ID を対応表に追加するか、setup-opencode をもう一度実行します |
{env:VAR} のキーが空である | OpenCode は、設定されていない変数を空の文字列に置き換える | 同じシェルで変数を export するか、/connect でキーを保存します |
| ツール呼び出しが失敗する | モデルのツール呼び出しが弱い | 上の表からモデルを選びます |
| 「All models rate-limited after N attempts」 | すべてのキーが上限に達している | 他のプロバイダのキーを追加するか、クールダウンが終わるまで待ちます |
よくある質問
OpenCode は無料で使えますか?
はい。OpenCode はオープンソースです。OpenAI 互換のプロバイダとして FreeLLMAPI に接続します。ゲートウェイは各リクエストを無料のプロバイダ枠に送るため、推論のコストは $0 です。
カスタムの OpenAI 互換プロバイダを OpenCode に追加するには?
opencode.json に、npm を @ai-sdk/openai-compatible に設定したプロバイダ、options.baseURL、models の対応表を追加します。次に /connect を実行してキーを保存し、/models を実行してモデルを選びます。
OpenCode に最適な無料モデルはどれですか?
ツール呼び出しに対応し、128K 以上のコンテキストを持つモデルを使ってください。このページの表に、現時点でその両方の条件を満たす、最も性能の高い無料モデルを示しています。freellmapi/auto を使うと、ルーターがモデルを選びます。
OpenCode は API キーをどこに保存しますか?
/connect で追加したキーは ~/.local/share/opencode/auth.json に保存されます。FreeLLMAPI のセットアップ用コマンドは、キーをそこに書き込むため、CLI とデスクトップアプリの両方がキーを見つけられます。
関連ガイド
- Aiderを無料LLM APIで使う
- 無料モデルでCodex CLIを使う
- Claude Codeを無料で使う方法
- 無料のコーディング向けモデルAPI
- 無料の OpenAI 互換 API の Base URL
出典
- OpenCode docs: providers (V1 config) (確認日 20 November 2026)
- OpenCode docs: config (確認日 20 November 2026)
- OpenCode docs: migrate from V1 (確認日 20 November 2026)
- FreeLLMAPI CLI generators (確認日 20 November 2026)
- FreeLLMAPI docs: context handoff (確認日 20 November 2026)