結論から: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 login | API Key を入力(環境変数から読むことも可) |
| リクエストを送るのは | ローカルの claude プログラム(公式 Claude Agent SDK 経由) | OpenCode 自身 |
| ツール・権限・履歴 | すべて OpenCode 側 | すべて OpenCode 側 |
| CLAUDE.md | Claude 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:バージョンを確認
opencode --version # 2.2.3+
claude --version # 2.1.248+
足りなければアップデート:
# 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 にログイン
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
/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 にない、または複数バージョンが入っている場合は環境変数で指定します。
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 を環境変数に入れる
export AICODEWITH_API_KEY="YOUR_API_KEY"
ステップ 2:opencode.json に baseURL を書く
プロジェクト直下の opencode.json、またはグローバルの ~/.config/opencode/opencode.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 を置いています。
# 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")
コマンド:
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 件すべて通りました。実際の出力:
> 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.
修正後のコード:
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 が同じファイルを読みます。
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 にしたときの応答:
Error: 不支持的请求路径,请检查 API 地址是否正确
https://api.aicodewith.ai/v1 に直せば解決します。
「请在请求中提供有效的 API Key」(有効な API Key がない)
{env:AICODEWITH_API_KEY} が空です。別のターミナルで export した、変数名を打ち間違えた、などが典型です。変数を空にして出たエラー:
Error: 请在请求中提供有效的 API Key。
CLAUDE.md を直しても反映されない
プロジェクトにすでに AGENTS.md があれば OpenCode はそれだけを使い、Claude Agent では Claude Code の CLAUDE.md 読み込みもオフです。前の節のとおりルールを AGENTS.md に移してください。
プランの上限に達した
設計ドキュメントによると、Claude Code が自分でリトライし、OpenCode はこのプロバイダーではリトライしないため、上限エラーは 1 回だけ表示されます。リセットを待つか、/models で API Key 方式に切り替えて続けます。



