ホーム / ガイド / 無料の LLM API で OpenCode を使う

無料の LLM API で OpenCode を使う

OpenCode は、ターミナルとデスクトップで使えるオープンソースのコーディングエージェントです。OpenAI 互換の任意のプロバイダを使えます。このガイドでは、FreeLLMAPI を通じて OpenCode を無料モデルに接続します。1 つのコマンドで設定を書き込み、キーを保存します。

コード、モデル名、ライブのカタログラベルは英語で表示します。

手順 1: FreeLLMAPI をインストールする

FreeLLMAPI は、オープンソースのゲートウェイです。お使いのコンピュータ上の Docker で動作し、45 社のプロバイダの無料枠を 1 つのキーにまとめます。

macOS または Linux にインストールする

curl -fsSL https://freellmapi.co/install.sh | bash

http://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 を追加してください。
設定のバージョンに関する注記: OpenCode のドキュメントでは、providers キーを持つ V2 の設定形式が説明されています。ドキュメントによると、上の V1 形式もサポートされています。FreeLLMAPI のセットアップ用コマンドは、V1 形式を書き込みます。

OpenCode に向くモデルを選ぶ

OpenCode はエージェントです。ツール呼び出しを通じて、ファイルを読み、編集し、コマンドを実行します。各リクエストには、システムプロンプト、ツールの定義、ファイルの内容が含まれます。ツール呼び出しに対応し、大きなコンテキストウィンドウを持つモデルを使ってください。

OpenCode 向けの無料モデル: ツール呼び出しと 128K 以上のコンテキスト
モデル無料で利用可能コンテキスト無料枠の上限(最良の条件)ツール画像入力
GLM 5.3UnoRouter1M1 リクエスト/分
1 req/min per model
はいいいえ
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 リクエスト/分
40 RPM
はいはい
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaはいはい
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceはいいいえ
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditはいはい
Gemini 3.7 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditはいはい
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 リクエスト/分
50 リクエスト/日
50 req/day account-wide (1,000 after a $10 purchase)
はいはい
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 リクエスト/分
50 リクエスト/日
Shared rate limit
はいいいえ
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 リクエスト/分
250 リクエスト/日
70,000 トークン/分
~6M
はいはい
Gemini 3.6 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Qwen 3.8 27BCloudflare Workers AI262KShared 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」すべてのキーが上限に達している他のプロバイダのキーを追加するか、クールダウンが終わるまで待ちます
これらすべてを 1 つのキーで利用できます。 FreeLLMAPI は、オープンソースのセルフホスト型ルーターです。これらの無料枠すべてを 1 つの OpenAI 互換エンドポイントの背後にまとめ、レート制限に達した場合は自動的に別のプロバイダーへ切り替えます。 カタログを見る または 公開.

よくある質問

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 とデスクトップアプリの両方がキーを見つけられます。

関連ガイド

出典

すべてのガイド · 無料モデルをすべて見る