著者注：OpenCode 2.2.3 で Claude Agent プロバイダーが追加されました。この記事では、3 月に提供が停止された OAuth プラグインとの違いを説明し、3 ステップの接続方法と 5 つの制限を紹介します。導入するかどうかの判断にお役立てください。
10 月 30 日、OpenCode 2.2.3 がリリースされ、Claude Agent プロバイダーが組み込まれました。接続方法は、ローカル環境に Claude Code をインストールし、claude auth login を一度実行した後、OpenCode の /connect で Claude Agent を選ぶだけです。これで、自分の Claude サブスクリプションを使って Claude モデルを利用できます。@opencode の公式発表は、10 月 31 日時点で約 51 万回閲覧されています。
これは、3 月に提供が停止された OAuth とは別の仕組みです。新しい方式では、Claude Code の公式バイナリと Claude Agent SDK を使用します。OpenCode はログイン認証情報を読み取らず、保存もしません。モデルへのリクエストは、ローカル環境の claude プロセスから送信されます。OpenCode 側は Anthropic の許可を得ていると説明していますが、Anthropic は個別の発表を行っていません。
開発者の Chen Cheng 氏（@chenchengpro）は、具体的な実装を分析しています。起動時に tools: [] と settingSources: [] を設定し、mcp__opencode__* ツールだけを許可する仕組みです。MCP ハンドラーは tool_use_id を取得できないため、PreToolUse フックで一度に 1 つずつ記録するしかなく、並列のファイル読み取りは逐次処理になります。システムプロンプトも Claude Code に標準搭載されたもののままで、同氏は「直接 Claude Code を使うよりも、効果は間違いなく劣る」と見ています。この記事では、3 ステップの接続方法と 5 つの制限、そして 3 つのタイプのユーザーそれぞれに適した選択肢を紹介します。
注：この記事は OpenCode のリリースノート、PR #58782 の設計文書、Claude Code の公式ドキュメント、コミュニティのフィードバックを基にまとめたものです。エンドツーエンドの実機検証は行っていません。
OpenCode で Claude のサブスクリプションを使う：まずは結論
結論は3つ。使えますが、以前の方法とは異なり、制約もあります。
- 前提条件：OpenCode V2 のバージョン 2.2.3 以降が必要です。同じマシンに Claude Code をインストールし、
claude auth loginでログインしておきます。 - 仕組み：OpenCode は Claude Agent SDK を通じて、ローカルの
claudeプロセスを呼び出します。OpenCode 独自の OAuth 実装ではなく、トークンの読み取りや保存も行いません。 - 制約：ツール呼び出しは逐次実行になります。Claude Code の多くの機能は使えず、ローカル環境でのみ動作します。ホスティング環境やリモート環境には対応していません。
「無料」についても、先に整理しておきましょう。Claude の無料プランには Claude Code が含まれていないため、この方法は使えません。Pro、Max、Ultra、Team、Enterprise のいずれかのプラン、または Console アカウントが必要です。また、追加料金なしで使い放題というわけでもありません。使用量はサブスクリプションの5時間ごとの上限と週間上限から消費されます。OpenCode の画面に $0 と表示されるのは、費用がサブスクリプションでカバーされているためです。
サブスクリプションを持っていない場合や、チームで共通の接続先を使いたい場合は、API の従量課金を利用する方法もあります。例えば、APIYI（apiyi.com）を通じて、OpenAI 互換インターフェースから Claude モデルを呼び出せます。この方法なら特定のマシンに縛られず、サブスクリプションの利用上限もありません。
OpenCodeのClaudeサブスクリプション連携はなぜ3月に削除され、10月に復活したのか
2026年には、次の4つの節目がありました。
- 1月9日：Anthropicがサードパーティ製ハーネスへの制限を強化。同日、OpenCodeにissue #7410「Broken Claude Max」が作成され、Claude Maxで突然エラーが発生したとユーザーから報告されました。
- 2月20日：Anthropicが規約を変更し、Agent SDKを使って構築した製品を含め、他の製品でOAuthトークンを使用することを明確に禁止したと海外メディアが報じました。
- 3月19日：OpenCodeがPR #18186「anthropic legal requests」をマージ。組み込みの
opencode-anthropic-authプラグインを削除し、プロバイダー一覧からanthropicを除外しました。 - 10月30日：OpenCode 2.2.3でClaude Agentが復活。同日公開の2.2.4では、ガイド付き設定も追加されました。
転機は規約の文面にありました。Anthropicの法務・コンプライアンスページの2月21日時点のWaybackアーカイブには、Free、Pro、MaxのOAuthトークンを他のあらゆる製品、ツール、サービス（Agent SDKを含む）で使用することは、Consumer ToSに違反すると記載されていました。9月30日時点のアーカイブでは、この文言が削除され、代わりに例外が追加されています。エンドユーザーは変更されていないClaude Codeのバイナリで自分のサブスクリプションを使ってログインでき、プラットフォームがClaude Codeをホスティングする場合も対象になります。10月のページにも、この例外は残っています。
OpenCodeのClaude Agentは、この例外に沿って設計されています。PR #58782のコメント欄でアカウントが停止される可能性を尋ねられた際、作者のTarquinen氏は、Anthropicの許可を得ており、ToSに完全に準拠していると回答しました。OpenCodeのメンバーであるDaniel Smolsky氏も、Xで「We got permission」と投稿しています。ただし、10月31日時点では、Anthropicによる個別の発表は確認できていません。そのため、「許可を得た」という情報は現時点ではOpenCode側の主張です。
| 比較項目 | 3月以前のOAuthプラグイン | 10月のClaude Agent |
|---|---|---|
| ログイン方法 | OpenCode自体がclaude.aiのOAuth認証を行い、トークンを取得 | ユーザーがローカルのClaude Codeでclaude auth loginを実行 |
| リクエストの送信元 | OpenCodeがAnthropic APIを直接呼び出す | ローカルのclaudeプロセスがAgent SDKを通じて送信 |
| トークンの読み取り・保存 | プラグインがOAuthトークンを保持 | 読み取りも保存もしない。/connectは選択した方法のみを記録 |
| Anthropicの姿勢 | 2月の規約で明確に禁止され、3月にプラグインが削除 | OpenCodeは許可を得たと説明。9月の規約で例外が追加されたが、個別の発表はなし |
| リスク | アカウント停止やプラグイン削除のリスクがある | 3月より低いが、ポリシーが再び変わる可能性がある |
リスクについても押さえておきましょう。現行の規約では、事前通知なしに規約を執行する権利が留保されているほか、サードパーティによるClaudeの認証情報の収集、保存、中継も引き続き禁止されています。利用する際は、ネット上に出回っている旧版のOAuthプラグインをインストールしないこと、そして他人のプラットフォームに自分のアカウントを登録して代理実行させないことに注意してください。
OpenCode Claude Agent の仕組み：処理の流れと直列実行の理由
処理の流れは、OpenCode → Claude Agent SDK → ローカルの claude → Anthropic です。OpenCode は Claude Code と Anthropic の間には入らず、リクエストも書き換えません。claude の実行ファイルはデフォルトで PATH から探しますが、環境変数 OPENCODE_CLAUDE_PATH でパスを指定することもできます。
起動時には、Claude Code の多くの機能が無効化または置き換えられます。まとめると、「3つを無効化、1つを置き換え、1つを直列化」です。
- 組み込みツールを無効化：
tools: []を設定し、Claude Code に標準搭載された読み書きツールや Bash ツールをすべて使わないようにします。 - ユーザー設定を無効化：
settingSources: []を設定し、~/.claudeやプロジェクト内の.claudeを読み込みません。CLAUDE.md、hooks、skills、MCP servers も読み込まれません。 - OpenCode のツールだけを許可：
mcp__opencode__*プレフィックスを持つツールだけを許可します。Claude が別のツール名を呼び出した場合、No such tool availableが返され、OpenCode はその呼び出しを実行しません。 - ツールの実装を置き換え：OpenCode は独自のツールをプロセス内 MCP server として提供し、実行時には OpenCode 独自の権限確認ダイアログを使います。システムプロンプトは Claude Code 標準のものをそのまま使い、「opencode 内で実行中」という一文を追加したうえで、選択した agent prompt と AGENTS.md を重ねます。
- ツールを直列実行：OpenCode の tool handler は Claude の
tool_use_idを取得できないため、PreToolUsehook でいったん記録してから取り出す必要があります。hook は一度に1つの ID しか記録できないため、ツールを並列実行可能として指定できません。Claude は本来、複数のファイルを同時に読み込めますが、ここでは1つずつ読み込むことになります。
OpenCode がこのように設計されているのには理由があります。どのモデルが生成した内容でも会話履歴の形式が統一されるため、モデルを切り替えても混乱が起きません。また、権限システムも全体で1つに統一できます。一方で、Claude Code が本来備えていた機能の多くが使えなくなるという代償もあります。陈成氏は「ここまでやると、効果は直接 claude code を使うより確実に劣る気がする」と評しています。連携するかどうかを決める前に、この点はよく考えておきましょう。
そのほかにも、いくつか動作上の詳細があります。各 session では長時間稼働する claude プロセスが1つ起動し、5分間アイドル状態が続くと停止します。次のメッセージが届くと再開します。失敗したリクエストは Claude Code 自身が再試行するため、OpenCode 側では重ねて再試行しません。
OpenCode で Claude サブスクリプションを連携する3ステップ
始める前に、次の5つの前提を確認しましょう。
- OpenCode は V2 の 2.2.3 以上で、V1 ではない。
- Claude Code がローカルにインストールされている。
- Claude アカウントが有料プラン、または Console アカウントである。
- OpenCode と Claude Code が同じマシンにインストールされている。
- hosted opencode やリモートワークスペースではない。
V2 は curl -fsSL https://opencode.ai/v2/install | bash でインストールできます。デスクトップ版をダウンロードすることも可能です。
Step 1：Claude Code をインストールする
確認すること：ターミナルで claude --version を実行します。コマンドが見つからないと表示された場合は、まだインストールされていません。
やること：macOS と Linux では公式の install.sh スクリプトを使い、Windows では PowerShell で公式の install.ps1 を実行します。すでにインストール済みでバージョンが古い場合は、claude update で更新します。
成功の目安：claude --version でバージョン番号が表示されます。
Step 2：Claude アカウントにログインする
確認すること：claude auth login を実行すると、ブラウザで Anthropic のログインページが開きます。
やること：有料の Claude アカウントでログインし、claude auth status を実行して状態を確認します。
成功の目安：認証方式が api_key や none ではなく、サブスクリプションによるログインになっています。
ここで注意したいのが、シェルに ANTHROPIC_API_KEY が設定されている場合です。Claude Code が API キーを優先し、従量課金になる可能性があります。ログイン前に unset ANTHROPIC_API_KEY を実行しましょう。Claude Code にこのキーを使うか尋ねられた場合は、拒否を選択します。
Step 3：OpenCode で Claude Agent に接続する
確認すること：OpenCode で /connect と入力すると、プロバイダーの一覧が表示されます。
やること：Claude Agent を選択します。「Anthropic」ではないので注意してください。続いて /models で Claude モデルを選びます。2.2.4 以降にはガイド機能があり、ログインコマンドのコピー、インストール状況の確認、接続の検証を経て、すべて完了するとモデル選択に進めます。コマンドラインに慣れている場合は、opencode auth login でも同じ操作ができます。
成功の目安：一覧から Claude モデルを選び、テスト用のプロンプトに返信が返ってきます。また、ツール呼び出し時に OpenCode の権限確認ポップアップが正常に表示されます。
トラブルシューティング
- 一覧に Claude Agent が見つからない：
opencode --versionでバージョンを確認し、2.2.3 未満なら更新します。あわせて、V2 がインストールされているか確認してください。 - claude が見つからないと表示される：
PATHを確認するか、OPENCODE_CLAUDE_PATHでclaudeの絶対パスを指定します。 - 何度もログインページに戻される：初期ユーザーから、1〜2回接続した後に切断され、再接続時にログインページに戻されるという報告があります。コミュニティで修正が進められているため、まずはターミナルで
claude auth loginを再実行し、/connectに戻ってみてください。 - plan limit に達したと表示される：サブスクリプションの5時間ごと、または週間の利用枠を使い切っています。上限がリセットされるまで待つ必要があります。
- リモート環境から接続できない：仕様上サポートされていないため、ローカルマシンでのみ利用できます。
もう一点、OpenCode V1 のプロバイダードキュメントには「Anthropic は Pro/Max を禁止している」という古い警告が残っていますが、これは3月以前の情報です。V1 の /connect で Claude Agent を探しても見つかりません。Claude Agent が使えるのは V2 のみです。
OpenCode で Claude サブスクリプションを使う際の5つの制限
| 制限 | 具体的な挙動 | 影響を受けやすい人 |
|---|---|---|
| ツールの逐次実行 | hook が一度に1つの tool_use_id しか記録できず、ファイルの並列読み込みが逐次実行になる |
大規模リポジトリを扱う人、複数ファイルにまたがるリファクタリングを行う人 |
| OpenCode のプロンプトが使われない | Claude Code のシステムプロンプトが使われ、OpenCode 組み込みのプロンプトは適用されない | OpenCode のデフォルトエージェントの動作に依存する人 |
| Claude Code の機能が使えない | /usage、auto mode、memory、cloud sessions、agent teams などがない |
Claude Code のヘビーユーザー |
| ローカル環境のみ | ホスト型・リモート環境はサポートされず、claude が同じマシン上に必要 |
クラウド開発、リモートチーム、CI |
| パラメータとプラグインに制限がある | temperature、top-p、seed、stop などのパラメータをサポートせず、http.request hook も実行されない |
細かなパラメータ調整やゲートウェイ経由の利用が必要な人 |
ツールの逐次実行：小規模なプロジェクトではあまり気になりませんが、1つのタスクで数十個のファイルを調べる場合、待ち時間が目に見えて長くなります。大規模なリファクタリングを頻繁に行う人は、この時間的コストも考慮しましょう。
OpenCode のプロンプトが使われない：カスタムエージェントのプロンプトは引き続き有効ですが、土台となる基本プロンプトには Claude Code のものが使われます。OpenCode 組み込みエージェントの動作に慣れている場合、切り替え後にモデルのスタイルが少し変わったと感じるかもしれません。
機能が使えない：この制限が最も大きな影響を及ぼします。設計文書には、Claude Code にはあって OpenCode 側では使えない機能として、auto mode、ultracode、auto memory、away summaries、cloud sessions、/teleport、agent teams、/loop、computer use、sandboxed Bash、notebook editing、組み込みスキルの /simplify や /verify などが挙げられています。
ローカル環境のみ：Claude のプロセスは5分間アイドル状態が続くと停止し、次のメッセージで再び起動します。CI やリモート開発マシンではこの方法を使えません。
パラメータとプラグインに制限がある：サンプリングパラメータはすべてサポートされません。base URL と headers は設定ファイルからしか読み込めず、プラグインがリクエストごとに変更することはできません。また、リクエストは Claude Code から送信されるため、http.request と http.response の2つの hook も実行されません。
使用量についても注意点があります。OpenCode では Claude の /usage を確認できず、上限に達しても自動的には続行されません。また、ここで追加の使用量を購入することもできません。OpenCode 自体の /usage に表示されるのは OpenCode Console の使用量であり、Claude サブスクリプションの利用枠とは無関係です。なお、claude -p や SDK のユーザーが使えるサブスクリプションの利用枠は、Claude Code を通常使用する場合より少ないという説もありますが、設計文書には「未検証」と明記されています。現時点では事実として扱えません。
一言でまとめると、auto mode、memory、cloud sessions、agent teams、computer use、notebook editing が必要なら、Claude Code を直接使いましょう。Claude モデルと OpenCode のツール・権限管理の組み合わせが必要で、かつツールの逐次実行を許容できる場合に、この方法を検討する価値があります。
OpenCodeでClaudeのサブスクリプションを使う：おすすめの人と避けたい人
ユーザーのタイプによって、大きく3つに分けられます。
- すでにOpenCode 2.xを使っていて、Claudeのサブスクリプションに加入し、ローカル環境だけでコードを書いている人：試す価値があります。同じハーネス内でClaudeと他のモデルを切り替えられ、APIに別途料金を支払う必要もありません。
- Claude Codeだけを使っている人：無理に変える必要はありません。そのままClaude Codeを使うほうが、機能が充実していて、ツールを並列実行でき、プロンプトもオリジナルのままです。
- チーム、CI、リモート開発で使う人、またはauto mode、memory、利用枠のダッシュボードに依存している人：おすすめしません。この方法はローカル環境でしか動作せず、一部の機能が使えないうえ、請求内容も不透明です。APIキーやAPIYI apiyi.comの従量課金を使うほうが適しています。
| プラン | 価格（10月27日時点） | おすすめの人 |
|---|---|---|
| Claude Pro | 月額$20 | 個人で軽く使う人。5時間単位と週単位の利用制限あり |
| Claude Max / Ultra | 月額$100 / $200 | 個人でヘビーに使う人 |
| OpenCodeクライアント | 無料・オープンソース | すべての人 |
| OpenCode Go（オプション） | 月額$10 | OpenCodeがホストするモデルを使いたい人。Claude Agentの利用に必須ではない |
| APIYI Claude Opus 5.5 | 入力$4 / 出力$20 | チームでの共有、CI、明確な請求内容が必要な人 |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | $2/$10、$0.1/$0.5 | 日常的なコーディング、バッチ処理 |
表中のAPIYIの価格はすべて100万トークンあたりの料金です。キャッシュ読み取りは別料金です。
💰 従量課金を選ぶなら：サブスクリプションに加入していない人、チームで共有したい人、費用の内訳を明確に把握したい人は、APIYI apiyi.comを利用できます。
messagesエンドポイント（Anthropicネイティブ形式）とchatエンドポイント（OpenAI互換形式）の両方を提供しており、base_urlにはhttps://api.apiyi.com/v1を入力します。モデルと価格はプラットフォームのモデル一覧を確認してください。
よくある質問 FAQ
Q1：OpenCode で Claude のサブスクリプションを使うと、アカウントが停止されますか？
リスクは 3 月より低くなっています。新しい方式は公式バイナリを経由し、OpenCode がトークンを読み取ることもないため、9 月の利用規約で追加された例外にも該当します。ただし、「許可を得ている」というのは OpenCode 側の説明であり、Anthropic は個別に発表していません。また、Anthropic は事前通知なしに規約を執行する権利を留保しています。古い OAuth プラグインは使わないでください。
Q2：/connect で Claude Agent が見つからないのはなぜですか？
多くの場合、バージョンが原因です。2.2.3 より古いか、まだ V1 を使っている可能性があります。V2 の最新版にアップグレードしたうえで、`/connect` から「Anthropic」ではなく「Claude Agent」を探してください。
Q3：OpenCode に費用 $0 と表示されますが、本当に無料ですか？
いいえ。$0 と表示されるのは、費用がサブスクリプションに含まれているためです。実際の使用量は、サブスクリプションの 5 時間ごとおよび週間の利用枠から消費されます。APIキーを使う場合は、OpenCode に models.dev の価格に基づいた費用が表示されます。
Q4：リモート開発マシンやクラウドで使えますか？
使えません。`claude` は OpenCode と同じマシンにインストールする必要があり、ホスト型ワークスペースとリモートワークスペースはいずれもサポートされていません。クラウドや CI で利用する場合は、APIキーを使うか、APIYI apiyi.com を通じた従量課金での呼び出しがおすすめです。
Q5：サブスクリプション接続と APIキーは、どう選べばよいですか？
サブスクリプション接続は、すでにサブスクリプション料金を支払っている人が、自分のマシンで個人的に使う場合に適しています。APIキーはマシンに縛られず、複数人で共有でき、請求も分かりやすいうえ、サブスクリプションの利用枠にも左右されません。Claude とほかのモデルを比較したい場合は、APIYI apiyi.com なら 1 つのキーでモデルを切り替えてテストできます。
Q6：Claude の無料版は使えますか？
使えません。無料版には Claude Code が含まれていないため、少なくとも Pro プラン、または Team、Enterprise、Console のアカウントが必要です。
まとめ：OpenCode で Claude サブスクリプションを使うための3つのポイント
接続できる：OpenCode 2.2.3 以降は、公式 Agent SDK を通じてローカルの claude を呼び出せます。OpenCode は Anthropic の許可を得ているとしていますが、ポリシーは変更される可能性があります。接続方法：Claude Code をインストールし、claude auth login を実行した後、/connect で Claude Agent を選択します。接続を避けたい場合：ツールの並列実行や Claude Code の全機能が必要な場合、リモートやチームで利用する場合は、Claude Code を直接使うか、APIYI apiyi.com を通じて従量課金で Claude を呼び出しましょう。
著者：APIYI 技術チーム
技術に関するお問い合わせ：Claude モデルの接続に関するご質問は、APIYI apiyi.com のトップページからお問い合わせください。詳しいドキュメントは docs.apiyi.com をご覧ください。
