OpenCode で Claude を使う 2 つの方法:Claude Agent のサブスクログインと API Key 設定(2.2.3+)

OpenCode 2.2.3 で Claude Agent プロバイダーが標準搭載されました。Claude Code 2.1.248 以降を入れて claude auth login を実行し、/connect で Claude Agent を選べば、Claude Code のログインとモデルを OpenCode で使えます。もう 1 つの方法は Anthropic プロバイダーに baseURL と API Key を設定するやり方です。両者の違い、それぞれの設定手順、CLAUDE.md から AGENTS.md への移行、よくあるエラー、API Key 方式の実際の出力をまとめます。

9 分钟阅读
OpenCode で Claude を使う 2 つの方法:Claude Agent のサブスクログインと API Key 設定(2.2.3+)

結論から:OpenCode 2.2.3 から、OpenCode に Claude Agent というプロバイダーが標準で入りました。Claude Code(2.1.248 以降)を入れ、ターミナルで claude auth login を実行し、OpenCode の /connect で Claude Agent を選ぶと、Claude Code のログインとモデルが OpenCode で使えます。これを告知した @opencode の投稿(「you can now use your claude subscription in OpenCode」)は 1 日で 62 万回以上表示されました。

ただし方法はこれだけではありません。OpenCode で Claude を使う方法は以前から 2 つあります。

  • サブスクログイン:/connect → Claude Agent。利用量は Claude アカウント側でカウントされます。
  • API Key:/connect → Anthropic、または opencode.json で anthropic プロバイダーに baseURL と Key を設定。利用量は Key 単位で記録されます。

以下、2 つの違い、それぞれの設定手順、そして切り替えると CLAUDE.md が効かなくなったように見える理由を説明します。

API Key を作成して OpenCode・Claude Code・Codex・Cursor で共有する →

2 つの方法を表で比較

項目Claude Agent(サブスクログイン)Anthropic(API Key)
必要なバージョンOpenCode 2.2.3+、ローカルに Claude Code 2.1.248+どの OpenCode でも可
ログイン方法ターミナルで claude auth loginAPI Key を入力(環境変数から読むことも可)
リクエストを送るのはローカルの claude プログラム(公式 Claude Agent SDK 経由)OpenCode 自身
ツール・権限・履歴すべて OpenCode 側すべて OpenCode 側
CLAUDE.mdClaude Code の CLAUDE.md 読み込みはオフ。ルールは AGENTS.md で渡すOpenCode 自身のルール読み込み(AGENTS.md 優先)
リモート / ホスト型ワークスペース非対応。claude と同じマシンで動かす必要あり対応
temperature などのサンプリング設定非対応対応

表の内容はすべて、OpenCode リポジトリにあるこのプロバイダーの設計ドキュメント claude-agent-provider.md と PR #58782 に基づいています。

選び方:

  • Claude のプランを持っていて、OpenCode は自分の PC だけで使う:Claude Agent。
  • サーバー、リモートワークスペース、CI で動かしたい。または OpenCode・Claude Code・Codex・Cursor で 1 つの Key を共有し、呼び出し記録を 1 か所で確認したい:API Key。
  • 両方設定して /models で切り替えることもできます。設計ドキュメントによると、履歴の正本は OpenCode 側にあり、Claude Agent に戻すと、見ていなかった部分が 1 つのメッセージにまとめて渡されます。

方法 1:Claude Agent のサブスクログイン(OpenCode 2.2.3+)

ステップ 1:バージョンを確認

bash
opencode --version   # 2.2.3+
claude --version     # 2.1.248+

足りなければアップデート:

bash
# OpenCode
opencode upgrade
# or: curl -fsSL https://opencode.ai/v2/install | bash
# or: npm i -g @opencode/cli@latest

# Claude Code
claude update
# or: curl -fsSL https://claude.ai/install.sh | bash

Claude Code は 2.1.248 以降が必要です。設計ドキュメントによると、OpenCode は Claude Code が毎ターン自動で足すコンテキスト(ネストした CLAUDE.md、スキル一覧、リマインダーなど)を省かせており、このオプションは 2.1.248 からしかありません。

ステップ 2:ターミナルで Claude Code にログイン

bash
claude auth login
claude --version
opencode

claude auth login はターミナルで実行します。Claude Code の中で /login と打つのではありません。2.2.4 のリリースノートでも、誤解を招く /login の案内が claude auth login に修正されています。

設計ドキュメントによると、OpenCode は Claude Code が保存したログイン情報を読みません。/connect は「このログイン方法を選んだ」ことを記録するだけで、リクエストはローカルの claude が自分で送ります。サブスク、API key、クラウドアカウントなど、claude が対応するログインならどれでも使えます。

ステップ 3:OpenCode で /connect → Claude Agent

text
/connect
  → Claude Agent      (Claude Code login)
  → Anthropic         (API Key)
/models

Anthropic ではなく Claude Agent を選びます。Anthropic は API Key の入り口で、Key の入力欄が出るだけです。2.2.4 以降は Claude Agent を選ぶとガイドが始まり、claude auth login のコピー、Claude Code のインストール、接続確認を経てモデル選択に進みます。デスクトップ版で Needs sign-in と出たときもここから復帰できます。

claude が PATH にない、または複数バージョンが入っている場合は環境変数で指定します。

bash
export OPENCODE_CLAUDE_PATH="$HOME/.local/bin/claude"
opencode

切り替え後に変わること

設計ドキュメントによると:

  • Claude Code の組み込みツールはオフ。Claude は OpenCode のツールを使い、ツール呼び出しはすべて OpenCode の権限確認を通ります。権限の仕組みは 1 つだけです。
  • Claude Code の設定は読まれません:~/.claude とプロジェクトの .claude フォルダーの設定、CLAUDE.md、hooks、MCP サーバー、skills はすべてオフで、OpenCode 側のものが使われます。自動コンパクションと自動メモリーもオフで、コンパクションは OpenCode が担当します。
  • システムプロンプトは Claude Code のものに、OpenCode の指示(AGENTS.md、skills、MCP の説明、選んだエージェントのプロンプトなど)が加わります。
  • 非対応の機能:Claude プランの /usage、クラウドセッションと /teleport、/loop、auto mode、computer use など。OpenCode の /usage は OpenCode Console の利用状況を表示します。
  • セッションごとに常駐の claude プロセスが 1 つ動き、5 分アイドルで終了します。次のメッセージで保存済みの Claude セッションが再開されます。

規約をめぐる議論

告知の返信欄では、Anthropic の規約に反しないかという質問が多く出ています。

  • Claude Agent SDK 公式の概要ページには、事前の承認がない限り、Anthropic はサードパーティ開発者が自社製品で claude.ai ログインやプランの利用枠を提供することを認めておらず、Claude Agent SDK で作ったエージェントも含まれる、と書かれています。代わりに API key 認証を使うよう案内しています。
  • OpenCode の設計ドキュメント自身も「Open Questions」に、Anthropic と話し合う必要や承認の要否を挙げています。
  • @grok によると、Anthropic はこの使い方を公に確認・承認していません。@schulzfel によると、公式 Agent SDK で実装されています。@jimmyyangrz によると、Claude のログインに依存するため試すのはよいが、ワークフローの土台にするのはリスクがあるとのことです。

本記事の公開時点で、Anthropic は OpenCode のこのプロバイダーについて公式にコメントしていません。サブスクアカウントのリスクについては「Claude アカウントが BAN される理由と Claude Code を API Key に切り替える方法」を参照してください。

方法 2:Anthropic プロバイダー + API Key

この方法は Claude Code 不要で、OpenCode が直接リクエストを送ります。AICodeWith の Key を使う設定は次のとおりです。

ステップ 1:Key を環境変数に入れる

bash
export AICODEWITH_API_KEY="YOUR_API_KEY"

ステップ 2:opencode.json に baseURL を書く

プロジェクト直下の opencode.json、またはグローバルの ~/.config/opencode/opencode.json:

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "{env:AICODEWITH_API_KEY}"
      }
    }
  },
  "model": "anthropic/claude-sonnet-5-5"
}

ポイント:

  • OpenCode の baseURL は /v1 付きの https://api.aicodewith.ai/v1。Claude Code とは違います。Claude Code の ANTHROPIC_BASE_URL は /v1 なしの https://api.aicodewith.ai です。
  • apiKey は {env:AICODEWITH_API_KEY} で環境変数から読むので、Key がプロジェクトのファイルや git に入りません。
  • apiKey を書かずに、/connect → Anthropic で Key を貼り付けても構いません。
  • /models で選べる Claude モデルを確認し、model は anthropic/モデル ID の形で書きます。

複数のクライアントで 1 つのアカウントを使うときの Key とアドレスの分け方は「Codex・OpenCode・WorkBuddy の複数ツール設定」、Claude Code 側は「Claude Code をサードパーティ API につなぐ」を参照してください。

実測:OpenCode 2.2.5 が AICodeWith の Key で小さなバグを直す

Linux マシンに OpenCode 2.2.5 を入れ、上の設定で slugify 関数を直させました。プロジェクトには「.py を変更したらテストを実行する」と書いた AGENTS.md を置いています。

python
# slug.py
def slugify(title):
    return title.lower().replace(" ", "-")

# test_slug.py
def test_basic(self):  self.assertEqual(slugify("Hello World"), "hello-world")
def test_punct(self):  self.assertEqual(slugify("OpenCode + Claude: Setup!"), "opencode-claude-setup")
def test_spaces(self): self.assertEqual(slugify("  a   b  "), "a-b")

コマンド:

bash
opencode run -m anthropic/claude-sonnet-5-5 \
  "Fix slugify in slug.py so all tests in test_slug.py pass. Follow AGENTS.md. Reply with one short summary line."

Enter から終了まで約 11 秒。OpenCode は 2 つのファイルを読み、slug.py を書き換え、AGENTS.md の指示どおりテストを実行して 3 件すべて通りました。実際の出力:

text
> build · claude-sonnet-5-5
→ Read slug.py
→ Read test_slug.py
← Write slug.py
Wrote file successfully: slug.py
$ python3 -m unittest 2>&1 | tail -5
...
Ran 3 tests in 0.000s
OK
I rewrote `slugify` in `slug.py` to turn each run of non-alphanumeric characters into one hyphen and strip hyphens from both ends, and `python3 -m unittest` now passes all 3 tests.

修正後のコード:

python
import re


def slugify(title):
    # Collapse every run of non-alphanumeric characters into a single hyphen
    return re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")

サブスク契約のある Claude アカウントは手もとにないため、方法 1 の手順は OpenCode のリリースノートと設計ドキュメントに沿って整理しています。

API Key を作成して、上の opencode.json を試す →

CLAUDE.md を AGENTS.md に移す

Claude Agent では Claude Code 自身の CLAUDE.md 読み込みがオフなので、プロジェクトのルールは OpenCode 経由で渡す必要があります。OpenCode のルールの優先順位(OpenCode Rules ドキュメント):

  • AGENTS.md と CLAUDE.md が両方あれば、AGENTS.md だけが使われる。
  • AGENTS.md がないときだけ CLAUDE.md が代わりに使われる。
  • グローバルの ~/.config/opencode/AGENTS.md は ~/.claude/CLAUDE.md より優先。

いちばん簡単なのは、ルールを AGENTS.md に移し、CLAUDE.md には読み込み用の 1 行だけ残すことです。これで OpenCode・Claude Code・Codex が同じファイルを読みます。

bash
git mv CLAUDE.md AGENTS.md
printf '@AGENTS.md\n' > CLAUDE.md
git add AGENTS.md CLAUDE.md

Claude Code は @AGENTS.md で内容を取り込みます。共有の詳しい書き方は「Claude Code と Codex で AGENTS.md を共有する」を参照してください。

よくあるエラー

/connect で API Key の入力欄しか出ない

Anthropic を選んでいます。それは API Key の入り口です。サブスクログインなら戻って Claude Agent を選んでください。一覧に Claude Agent がなければ OpenCode が 2.2.3 より古いので opencode upgrade を実行します。

Claude Agent がつながらない・ログインを求められる

順に確認:claude --version が 2.1.248+ か、ターミナルで claude auth login を実行したか、claude が PATH にあるか(なければ OPENCODE_CLAUDE_PATH を設定)。リモートワークスペースやホスト型 OpenCode ではこのプロバイダーは使えません。

「不支持的请求路径」(リクエストパスが非対応)

API Key 方式で baseURL に /v1 が抜けています。わざと https://api.aicodewith.ai にしたときの応答:

text
Error: 不支持的请求路径,请检查 API 地址是否正确

https://api.aicodewith.ai/v1 に直せば解決します。

「请在请求中提供有效的 API Key」(有効な API Key がない)

{env:AICODEWITH_API_KEY} が空です。別のターミナルで export した、変数名を打ち間違えた、などが典型です。変数を空にして出たエラー:

text
Error: 请在请求中提供有效的 API Key。

CLAUDE.md を直しても反映されない

プロジェクトにすでに AGENTS.md があれば OpenCode はそれだけを使い、Claude Agent では Claude Code の CLAUDE.md 読み込みもオフです。前の節のとおりルールを AGENTS.md に移してください。

プランの上限に達した

設計ドキュメントによると、Claude Code が自分でリトライし、OpenCode はこのプロバイダーではリトライしないため、上限エラーは 1 回だけ表示されます。リセットを待つか、/models で API Key 方式に切り替えて続けます。

参考情報

相关文章

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK は、Vercel が 2026 年 11 月 12 日に公開した Agent 向けの振る舞い(behaviors)ライブラリで、バージョンは 0.1.0-beta.1 です。振る舞いはフレームワーク非依存の @ui-sdk/core にあり、React、Vue、Svelte、Solid、Web Components のアダプターが描画します。公式ドキュメントに沿って「何か」「どう入れるか」「Claude Code / Codex / Cursor に skill をどう渡すか」を整理し、テスト機で実際に走ったコマンド、所要時間、出力を記録します。

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator は AWS 公式のローカル AWS エミュレーターで、2026 年 11 月 11 日(米国時間)に一般提供(GA)が始まりました。追加のサービス料金はかからず、ソースは公開されており、AWS アカウントも不要で、200 以上のサービスをカバーします。本記事では Debian 13 上で 1.0.322 を検証し、インストールコマンド、AWS CLI をローカル endpoint に向けて S3 バケットと DynamoDB テーブルを作る手順、遭遇したエラー、Claude Code・Codex・Cursor にエミュレーター相手でコードを書かせてテストさせる方法をまとめます。

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code は pingdotgg が公開しているオープンソースのコーディングエージェント用コンソールです。モデルは内蔵しておらず、マシンにインストール済みの Claude Code、Codex、Cursor などの CLI を操作します。Linux 上で T3 Code 0.1.9 を検証し、インストールコマンド、Claude Code と Codex を AICodeWith API Key につないで T3 Code から操作する設定、t3 thread コマンドで両方を動かした結果、実際に出たエラーと対処法をまとめました。