OpenCode入門 — 18.6万スターのCLI、無料モデルはAPIキー不要だった

はじめに

OpenCode（sst/opencode）は「75以上のLLMプロバイダに対応するオープンソースAIコーディングエージェント」を謳うCLIツールです。GitHubスター数は18.6万（2026年7月時点、GitHubリポジトリ確認）に達し、Anthropic製のClaude Codeを上回る勢いで支持を集めています。

「75以上のプロバイダ対応」という数字だけを見ると、セットアップが大変そうに感じます。しかし実際にインストールしてAPIキーを一切設定せずに動かしてみたところ、設定ゼロで動く無料モデルが最初から6個用意されている ことが分かりました。この記事では、その仕組みと実際の動作ログを共有します。

この記事で学べること

• OpenCodeを実際にインストールしてから最初のレスポンスを得るまでの手順
• APIキー無しで使える無料モデルの正体と、それが機能する仕組み
• 「75+プロバイダ対応」の実態（公式ドキュメント記載内容との比較）

対象読者

• 複数のLLMプロバイダを切り替えて使うCLIコーディングエージェントに興味がある方
• OpenCodeを試す前に、実際の挙動を知っておきたい方

前提環境

• OS: Linux（クラウド実行コンテナ）
• Node.js: v22.22.2
• npm: 10.9.7
• opencode-ai: v1.18.1（npm install opencode-ai@latest で導入。2026年7月時点の最新版）

TL;DR

• OpenCodeは公式ドキュメントで「75以上のLLMプロバイダに対応」と明記されている（OpenAI、Anthropic、Google Vertex AI、Amazon Bedrock、Azure OpenAI、Groq、DeepSeekなど）
• ただし npm install 直後・環境変数もAPIキーも一切設定していない状態で opencode models を実行すると、認証不要の opencode/ プロバイダ配下に 6個の無料モデル（big-pickle / deepseek-v4-flash-free / hy3-free / mimo-v2.5-free / nemotron-3-ultra-free / north-mini-code-free）が最初から表示され、そのまま実行できる
• opencode run "質問" -m opencode/big-pickle は本当にAPIキー無しでレスポンスを返した（実行ログは後述）
• 他プロバイダ（Amazon Bedrock・Google・OpenAI等）は「環境変数の名前を認識している」だけで、実際に使うにはそれぞれの認証情報を別途設定する必要がある

背景・課題

公式ドキュメントを確認すると、OpenCodeは次のように多数のプロバイダに対応しています。

OpenCode supports 75+ LLM providers, including OpenAI, Anthropic, Google Vertex AI, Amazon Bedrock, Azure OpenAI, Groq, DeepSeek, xAI, Ollama、LM Studioなど

「75+プロバイダ」という表現だけだと、使い始めるにはどこかのプロバイダに登録してAPIキーを発行する前提のように読めます。実際に何もセットアップしていない状態でどこまで動くのかを、クラウド実行環境で試しました。

やったこと

ステップ1: インストールとバージョン確認

npm install opencode-ai@latest
./node_modules/.bin/opencode --version

実行結果:

1.18.1

依存パッケージは0件（opencode-ai 自体はネイティブバイナリのラッパー）で、インストールは約10秒で完了しました。

ステップ2: 認証情報を何も設定せずに providers list を実行

opencode providers list

実行結果（抜粋）:

T  Credentials  ~/.local/share/opencode/auth.json
|
—  0 credentials

T  Environment
|
•  Cloudflare Workers AI  CLOUDFLARE_ACCOUNT_ID
•  Google                 GEMINI_API_KEY
•  OpenAI                 OPENAI_API_KEY
•  Cloudflare AI Gateway  CLOUDFLARE_API_TOKEN
•  Cloudflare AI Gateway  CLOUDFLARE_ACCOUNT_ID
•  Amazon Bedrock         AWS_ACCESS_KEY_ID
•  Amazon Bedrock         AWS_SECRET_ACCESS_KEY
|
—  7 environment variables

保存済み認証情報は 0 credentials。「Environment」欄はAPIキーの値ではなく、環境変数の "名前" を認識できるプロバイダの一覧 でした。つまりこの時点ではどのプロバイダも実際には使えない状態です。

ステップ3: opencode models で使えるモデルを確認

opencode models

実行結果は305行のモデル一覧でしたが、プロバイダ別に集計すると次の6種類のみでした。

amazon-bedrock
cloudflare-ai-gateway
cloudflare-workers-ai
google
openai
opencode

このうち opencode/ プレフィックスのモデルは以下の6個で、認証情報なしでそのまま実行できるモデル でした。

opencode/big-pickle
opencode/deepseek-v4-flash-free
opencode/hy3-free
opencode/mimo-v2.5-free
opencode/nemotron-3-ultra-free
opencode/north-mini-code-free

ステップ4: 実際に無料モデルへ質問を投げる

opencode run "1+1は何ですか？一言で答えて" -m opencode/big-pickle

実行結果:

> build · big-pickle

2

APIキー・環境変数を一切設定していない状態から、インストール後わずか数コマンドで応答が返ってきました。念のため別モデルでも確認します。

opencode run "Pythonでリストの重複を消すワンライナーを書いて" -m opencode/deepseek-v4-flash-free

実行結果:

> build · deepseek-v4-flash-free

```python
list(dict.fromkeys(lst))
```

または順序を気にしないなら `list(set(lst))`。

こちらも問題なく応答しました。

ステップ5: コスト・トークン使用量の確認

opencode stats

実行結果（抜粋）:

OVERVIEW
Sessions                                              1
Messages                                              2
Days                                                  1

COST & TOKENS
Total Cost                                        $0.00
Avg Tokens/Session                                 9.1K
Input                                              8.0K
Output                                                4
Cache Read                                         1.0K

Total Cost は $0.00 でした。一方で Input トークンが8.0Kと、"1+1は何ですか？"という短い質問にしては大きめの数値でした。これはOpenCodeがエージェント動作用のシステムプロンプト・ツール定義を毎回コンテキストに含めているためと考えられます（無料モデルでもトークン消費自体は発生する点は覚えておく必要があります）。

ハマりポイント

「75+プロバイダ対応」と「今すぐ使えるモデル」は別物

opencode providers list の「Environment」欄は、環境変数を 設定すれば 使えるようになるプロバイダの候補であり、実際に使えるかどうかは無関係でした。「75+プロバイダ対応」を鵜呑みにして期待値を上げすぎると、最初の opencode models の結果（6プロバイダ・305モデルの大半が未認証では選択不可）に戸惑う可能性があります。この点は公式ドキュメントの「Providers」ページにも、プロバイダごとに個別の認証手順が必要な旨が明記されています。

MCP・ACPサーバーは未設定状態だと空

opencode mcp list

T  MCP Servers
|
!  No MCP servers configured
|
—  Add servers with: opencode mcp add

opencode mcp はMCPサーバーの追加・認証・デバッグを行うサブコマンド群、opencode acp はAgent Client Protocol（Zed等のエディタ連携用）のサーバー起動コマンドとして用意されていますが、いずれも初期状態では何も設定されていません。ローカルモデルのセルフホスト運用（Ollama連携等）は別記事で扱っていますが、今回確認したMCP連携やACPサーバーの活用は別途の設定が前提になります。

著者視点の発見ポイント

実際に手を動かして分かったのは、「75+プロバイダ対応」という数字は 将来的な拡張性の宣伝文句 であり、初回体験の速さとは別軸で評価すべきという点です。むしろOpenCodeが優れているのは、opencode/ という自前のモデルゲートウェイを用意して、インストール直後に一切の登録作業なしで動く無料モデルを6個提供している ことでした。CLIコーディングエージェントを試すハードルを下げる設計として、これは地味ながら効果の大きい工夫だと感じました。一方で Total Cost: $0.00 の裏でも8Kトークン前後のコンテキストが毎回消費される点は、無料だからといって「軽い」わけではないという実測データとして記録しておきます。

まとめ

• OpenCodeは公式に75+プロバイダ対応を謳うが、認証情報なしで即座に使えるのは opencode/ 配下の6モデルのみ
• npm install opencode-ai@latest → opencode run "質問" -m opencode/big-pickle の2コマンドで、APIキーなしに動作確認ができた
• 他プロバイダ（Bedrock/Google/OpenAI等）は環境変数名を認識しているだけで、利用には別途認証が必要
• 無料モデルでも $0.00 課金の裏でトークンは相応に消費されるため、大量利用時は opencode stats でモニタリングするとよい

参考リンク

• sst/opencode（GitHub） — スター数18.6万、MITライセンス、最新版v1.18.1（2026-07-14）の確認元
• OpenCode公式ドキュメント: Providers — 「75+プロバイダ対応」の記載元
• opencode-ai（npm） — インストール元パッケージ