作者注：OpenCode 2.2.3 新增 Claude Agent provider。本文說明它和 3 月被下架的 OAuth 插件有什麼區別，給出 3 步接入方法，並列出 5 個限制，幫你判斷要不要接。
10 月 30 日，OpenCode 發佈 2.2.3，新增內置 Claude Agent provider。接入方式是：本機裝好 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 沒有單獨發佈公告。
開發者陳成（@chenchengpro）拆解了具體實現：啓動時設置 tools: [] 和 settingSources: []，只放行 mcp__opencode__* 工具。由於 MCP handler 拿不到 tool_use_id，只能靠 PreToolUse hook 一次記錄一個，所以並行讀文件會變成串行。system prompt 仍然是 Claude Code 自帶的，他的判斷是“效果肯定不如直接用 Claude Code”。本文給出 3 步接入方法、5 個限制，以及 3 類人分別該怎麼選。
說明：本文依據 OpenCode release notes、PR #58782 設計文檔、Claude Code 官方文檔和社區反饋整理，沒有做端到端實測。
OpenCode 用 Claude 訂閱：先說結論
結論分三點：能用，但不是舊方案，而且有代價。
- 前提：OpenCode V2 的 2.2.3 及以上版本；Claude Code 裝在同一臺機器上，並已用
claude auth login登錄。 - 它是什麼：OpenCode 通過 Claude Agent SDK 調用你本機的
claude進程。它不是 OpenCode 自己實現的 OAuth，不讀取 token，也不存儲 token。 - 代價：工具調用變成串行；Claude Code 的不少功能用不了；只能在本機運行，不支持 hosted 或 remote 環境。
關於“免費”，需要先說清楚。Claude 免費版不包含 Claude Code，所以不能用這條路。你需要 Pro、Max、Ultra、Team、Enterprise 計劃之一，或者 Console 賬號。這也不是白嫖：用量仍然從你訂閱的 5 小時限額和每週限額里扣，只是 OpenCode 界面上會顯示 $0，因爲費用已由訂閱覆蓋。
如果你手上沒有訂閱，或者團隊需要共用一個入口，可以走 API 按量計費，例如通過 API易 apiyi.com 用 OpenAI 兼容接口調用 Claude 模型。這種方式沒有本機綁定，也沒有訂閱額度的限制。
OpenCode Claude 訂閱爲什麼 3 月被下架、10 月又能回來
這件事在 2026 年經歷了四個節點：
- 1 月 9 日：Anthropic 收緊對第三方 harness 的限制。當天 OpenCode 出現 issue #7410《Broken Claude Max》，有用戶報告 Claude Max 突然報錯。
- 2 月 20 日：外媒報道 Anthropic 修改了條款，明確禁止把 OAuth token 用在其他產品中，包括基於 Agent SDK 構建的產品。
- 3 月 19 日：OpenCode 合併 PR #18186《anthropic legal requests》，刪除了內置的
opencode-anthropic-auth插件，並從 provider 列表中移除 anthropic。 - 10 月 30 日：OpenCode 2.2.3 帶着 Claude Agent 迴歸，當天的 2.2.4 又加入了引導式配置。
轉折出現在條款原文裏。Anthropic 法律合規頁面 2 月 21 日的 Wayback 存檔仍然寫着：把 Free、Pro、Max 的 OAuth token 用在任何其他產品、工具或服務中（包括 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，拿到 token | 用戶在本機 Claude Code 裏執行 claude auth login |
| 誰發請求 | OpenCode 直接調用 Anthropic API | 本機 claude 進程通過 Agent SDK 發出 |
| 讀取或存儲 token | 插件持有 OAuth token | 不讀、不存，/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 的很多東西會被關掉或替換。可以歸納爲“三關掉、一換掉、一串行”：
- 關掉內置工具：設置
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 自己的權限彈窗。system prompt 用的仍是 Claude Code 自帶的那份，外加一句“正在 opencode 裏運行”，再疊加你選擇的 agent prompt 和 AGENTS.md。
- 工具串行執行：OpenCode 的 tool handler 拿不到 Claude 的
tool_use_id，只能由PreToolUsehook 先記下來再取出。hook 一次只能記一個 ID，所以工具不能標記爲可並行。Claude 本來會一次併發讀多個文件，到這裏就變成逐個讀取。
OpenCode 這樣設計有它的理由。不管是哪個模型生成的內容，會話歷史的格式都一樣，切換模型時不會混亂；而且全局只有一套權限系統。代價是 Claude Code 原有的能力被拆掉了不少。陳成的評價是：“這一套下來，感覺效果肯定不如直接用 claude code 好。”這一點在決定接不接之前就要想清楚。
另外還有幾個運行細節：每個 session 會起一個長期運行的 claude 進程，空閒 5 分鐘後停止，下一條消息到來時恢復；失敗的請求由 Claude Code 自己重試，OpenCode 不再重複重試。
OpenCode 接入 Claude 訂閱 3 步走
開始之前，先確認以下 5 個前提：
- OpenCode 是 V2 的 2.2.3 及以上版本，不是 V1。
- Claude Code 裝在本機。
- Claude 賬號是付費計劃，或者是 Console 賬號。
- OpenCode 和 Claude Code 在同一臺機器上。
- 不是 hosted opencode，也不是 remote workspace。
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。
這裏有個坑：如果你的 shell 裏設置了 ANTHROPIC_API_KEY，Claude Code 可能優先走 API key，變成按量扣費。登錄前先執行 unset ANTHROPIC_API_KEY；如果 Claude Code 詢問是否使用這個 key，選拒絕。
Step 3：在 OpenCode 裏連接 Claude Agent
會看到什麼：在 OpenCode 裏輸入 /connect，會彈出 provider 列表。
做什麼：選擇 Claude Agent，注意不是“Anthropic”。然後用 /models 選擇一個 Claude 模型。2.2.4 及以上版本會有引導流程：幫你複製登錄命令、檢查安裝情況、驗證連接，全部通過後再進入模型選擇。習慣用命令行的話，也可以用 opencode auth login 完成同樣的操作。
怎麼判斷成功：能在列表裏選到 Claude 模型，發一條測試 prompt 能收到回覆，並且調用工具時 OpenCode 的權限彈窗正常出現。
排錯清單
- 列表裏找不到 Claude Agent：執行
opencode --version檢查版本，低於 2.2.3 就升級；同時確認裝的是 V2。 - 提示找不到 claude：檢查
PATH，或者用OPENCODE_CLAUDE_PATH指定claude的絕對路徑。 - 反覆跳回登錄頁：有早期用戶反饋，連上一兩次後掉線，重連時會跳到登錄頁。社區還在修復，可以先在終端重新執行
claude auth login，再回到/connect。 - 提示到達 plan limit：說明訂閱的 5 小時或每週額度用完了，只能等限額重置。
- 遠程環境連不上：設計上就不支持，只能在本機使用。
還要提醒一點：OpenCode V1 的 providers 文檔裏還留着“Anthropic 禁止 Pro/Max”的舊警告，那是 3 月之前的口徑。別拿 V1 的 /connect 去找 Claude Agent，它只在 V2 裏有。
OpenCode 用 Claude 訂閱的 5 個限制
| 限制 | 具體表現 | 對誰影響大 |
|---|---|---|
| 工具串行 | hook 一次只記一個 tool_use_id，並行讀文件變成逐個讀取 |
大倉庫、跨多文件重構 |
| prompt 不是 OpenCode 的 | 用的是 Claude Code 的 system prompt，OpenCode 內置 prompt 不生效 | 依賴 OpenCode 默認 agent 行爲的人 |
| Claude Code 功能缺失 | 沒有 /usage、auto mode、memory、cloud sessions、agent teams 等 |
重度 Claude Code 用戶 |
| 只能本機 | hosted 和 remote 不支持，claude 必須在同一臺機器上 |
雲端開發、遠程團隊、CI |
| 參數和插件受限 | 不支持 temperature、top-p、seed、stop 等參數，http.request hook 不運行 |
需要精細調參或走網關的人 |
工具串行：小項目裏感覺不明顯。但如果一次任務要掃幾十個文件，等待時間會明顯變長。經常做大範圍重構的人，要把這部分時間成本算進去。
prompt 不是 OpenCode 的：自定義 agent prompt 仍然生效，但底層的基礎 prompt 是 Claude Code 那份。如果你已經習慣了 OpenCode 內置 agent 的行爲方式，切過來後可能會覺得模型的風格有些變化。
功能缺失：這一項影響最大。設計文檔列出了 Claude Code 有、而 OpenCode 這邊沒有的功能，包括 auto mode、ultracode、auto memory、away summaries、cloud sessions、/teleport、agent teams、/loop、computer use、sandboxed Bash、notebook editing，以及內置的 /simplify、/verify 等 skills。
只能本機：Claude 進程空閒 5 分鐘後會停止，下一條消息再恢復。在 CI 或遠程開發機上不能這樣用。
參數和插件受限：採樣參數一律不支持。base URL 和 headers 只能從配置文件讀取，插件不能按請求修改，http.request 和 http.response 這兩個 hook 也不會運行，因爲請求是由 Claude Code 發出的。
用量方面還有幾點要注意：在 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 訂閱：誰該用、誰別用
按人羣來分，大致是三種情況：
- 已經在用 OpenCode 2.x、有 Claude 訂閱、只在本機寫代碼：值得一試。你可以在同一個 harness 裏切換 Claude 和其他模型，不用爲 API 單獨付費。
- 純 Claude Code 用戶：別折騰。直接用 Claude Code，功能更完整、工具可以並行、prompt 也是原版的。
- 團隊、CI、遠程開發，或者依賴 auto mode、memory、額度面板的人：別用。這套方案只能在本機運行，功能有缺失，賬單也不透明，走 API key 或 API易 apiyi.com 按量計費更合適。
| 方案 | 價格（截至 10-27） | 適合誰 |
|---|---|---|
| Claude Pro | $20/月 | 個人輕度使用，有 5 小時和每週限額 |
| Claude Max / Ultra | $100 / $200 每月 | 重度個人用戶 |
| OpenCode 客戶端 | 免費開源 | 所有人 |
| OpenCode Go（可選） | $10/月 | 需要 OpenCode 託管模型的人，不是使用 Claude Agent 的前提 |
| API易 Claude Opus 5.5 | 輸入 $4 / 輸出 $20 | 團隊共用、CI、需要清晰賬單 |
| API易 Claude Sonnet 5.5 / Haiku 5.5 | $2/$10、$0.1/$0.5 | 日常編碼、批量任務 |
表中 API易 的價格單位都是每百萬 tokens，緩存讀取另外計價。
💰 按量方案建議：沒有訂閱、需要團隊共用、或者要把每一筆費用算清楚的，可以使用 API易 apiyi.com。它同時提供
messages端點（Anthropic 原生格式）和chat端點（OpenAI 兼容格式），base_url 填https://api.apiyi.com/v1。型號與價格以平臺型號列表爲準。
常見問題 FAQ
Q1：OpenCode 用 Claude 訂閱會被封號嗎？
風險比 3 月低：新方案走的是官方二進制，OpenCode 不讀取 token，也符合 9 月條款新增的例外。但“已獲許可”是 OpenCode 的說法，Anthropic 沒有單獨公告，並且保留不提前通知的執法權。不要用舊的 OAuth 插件。
Q2：爲什麼在 /connect 裏找不到 Claude Agent？
大多是版本問題：要麼低於 2.2.3，要麼還在用 V1。升級到 V2 的最新版本後，在 `/connect` 裏找“Claude Agent”，不是“Anthropic”。
Q3：OpenCode 顯示費用 $0，是真的免費嗎？
不是。顯示 $0 只是因爲費用已由訂閱覆蓋，實際用量仍然扣你訂閱的 5 小時和每週額度。如果走的是 API key，OpenCode 會按 models.dev 上的價格顯示費用。
Q4：能在遠程開發機或雲端使用嗎？
不能。`claude` 必須和 OpenCode 裝在同一臺機器上，hosted 和 remote workspace 都不支持。雲端或 CI 場景建議使用 API key，或者通過 API易 apiyi.com 按量調用。
Q5：訂閱接入和 API key 相比怎麼選？
訂閱接入適合個人在本機使用，前提是已經付了訂閱費。API key 不綁定機器，可以多人共用，賬單清晰，也不受訂閱限額影響。如果想同時對比 Claude 和其他模型，API易 apiyi.com 用一個 Key 就能完成切換測試。
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，或者通過 API易 apiyi.com 按量調用 Claude。
作者：API易 技術團隊
技術交流：Claude 模型的接入問題，可以在 API易 apiyi.com 首頁聯繫我們，更多文檔見 docs.apiyi.com。
