用 OpenHands 跑 Claude Code、Codex：ACP 是什麼，已經有訂閱的人怎麼接

先講結論：已經付了訂閱，就不用再付一次 API 費

很多人同時在用好幾個 coding agent：寫程式用 Claude Code，有時候切 Codex 比較一下，偶爾開 Gemini CLI。每個都有自己的終端機視窗、自己的對話紀錄，切來切去很亂。

OpenHands 的 Agent Canvas 可以把它們收進同一個畫面。你在 OpenHands 裡選 Claude Code，實際動手的就是你電腦上那個 Claude Code，用的是它原本登入的帳號。

這代表一件很實際的事：如果你已經有 Claude 或 ChatGPT 的付費訂閱，接進 OpenHands 之後走的還是訂閱額度，不用另外申請 API key、另外付一次錢。 官方在 2026 年 6 月的說明裡就是這樣講的。

讓這件事成立的是一個叫 ACP 的規格。

ACP 是什麼

ACP 全名是 Agent Client Protocol，你可以把它想成 coding agent 的「通用插座」。

只要一個 agent 支援 ACP，任何支援 ACP 的介面都可以接它，不用每家各寫一套。OpenHands 的 Agent Canvas 是其中一個介面，Zed、JetBrains 這些編輯器也支援，Cline 也可以用 ACP 模式被別的編輯器接。

在 OpenHands 裡，分工是這樣的：

OpenHands 負責畫面、對話列表、專案資料夾、自動化排程。

你選的 agent 負責實際動手：讀檔、改碼、跑指令，用的是它自己的工具和它自己的帳號。

所以接 Claude Code 的時候，你得到的是「Claude Code 的腦袋和手，放在 OpenHands 的畫面裡」，不是 OpenHands 自己的 agent 換了一個模型。這個差別後面會一直用到。

可以接哪些

Agent Canvas 內建三個選項，選了就能用：

Claude Code：走你的 Claude 帳號。

Codex：走你的 ChatGPT 帳號。

Gemini CLI：走你的 Google 帳號。

另外還有一個 Custom 選項，可以填任何支援 ACP 的 agent 啟動指令。OpenHands 底層的 SDK 也登錄了 OpenCode、Kimi Code 等 agent，但在畫面上不是一鍵選的，要自己填指令，比較適合已經熟這些工具的人。

設定步驟

1. 先在同一台電腦把 agent 裝好、登入一次

這是最容易卡住的地方。OpenHands 不會幫你登入，它是去讀那個 agent 在電腦上已經存好的登入資料。

Claude Code：在終端機開一次 claude，照指示用你的 Claude 帳號登入。

Codex：在終端機執行 codex login，用 ChatGPT 帳號登入。

Gemini CLI：開一次 gemini，用 Google 帳號登入。

要注意「同一台電腦」指的是跑 OpenHands 後端的那台。如果你是在自己電腦上用 npm 或桌面版跑 Agent Canvas，那就是你自己的電腦，登入過就好，OpenHands 裡的憑證欄位可以全部留空。

2. 在 OpenHands 裡選 agent

兩個地方都能選：

第一次打開的設定精靈，第一步「Choose your agent」直接選 Claude Code、Codex 或 Gemini CLI。

已經在用的話，到 Settings > Agent，把 Agent 切成 ACP，Preset 選你要的那一個。

想指定模型，例如 Claude Code 固定用某個版本，可以在這裡覆寫。

改完之後只有新開的對話會用新設定，已經開著的對話不會跟著換。

3. Docker 版要多一步

如果你的 Agent Canvas 是用 Docker 跑的，容器裡讀不到你電腦上的登入資料，必須另外提供憑證：

Claude Code 要設 CLAUDE_CODE_OAUTH_TOKEN。

Codex 要設 CODEX_AUTH_JSON。

這兩個值等於你帳號的登入鑰匙，請用 OpenHands 的 Settings > Secrets 存，不要貼在對話或寫進專案檔案裡。另外，用 Claude 的登入 token 時，不要同時設 ANTHROPIC_BASE_URL，兩個一起設會衝突。

安裝方式的差別，可以回頭看 Agent Canvas 安裝教學。

為什麼可以省錢，以及省不到的地方

用 API key 跑 agent，是用多少付多少。agent 會自己來回讀檔、思考、跑指令很多輪，一個下午燒掉幾美金很常見，詳細可以看 AI coding agent 一個月會燒多少錢。

訂閱是固定月費，在額度內用不會多收錢。所以本來就有訂閱的人，透過 ACP 接進 OpenHands，等於多了一個介面，但帳單不變。

但有三件事要先想清楚：

額度是同一份。 你在 OpenHands 裡用 Claude Code，扣的就是你 Claude 訂閱的用量。在 OpenHands 裡跑多了，回到終端機用 Claude Code 時，可能會比較早碰到上限。

排程自動化會在你沒看的時候用掉額度。 OpenHands 的自動化可以指定用 Claude Code 這類 agent 來跑，很方便，但設成每 15 分鐘跑一次，額度消耗也是持續的。

各家訂閱對「在別的介面裡用」有沒有限制，官方都沒寫清楚。 一般個人使用大多沒問題，但如果你打算長時間、大量地透過 OpenHands 跑，先看一下自己方案的使用條款比較保險。

什麼時候用 OpenHands 自己的 agent，什麼時候接 Claude Code

這兩種不是誰比較好，而是適合的情況不一樣。

接 Claude Code、Codex 比較划算的情況：

你已經有訂閱，不想再多付一筆 API 費。

你已經習慣某個 agent 的做事方式，只是想要一個比較好管理的畫面。

你想用 OpenHands 的排程自動化，但讓熟悉的 agent 來執行。

用 OpenHands 原生 agent 比較好的情況：

你想自由換模型，包括比較便宜的模型或本機模型。

你想用 OpenHands 自己的功能，例如對話太長時自動整理前文、用另一個模型幫忙檢查結果再重試。這些功能接 ACP agent 時都不會套用，因為動手的是那個 agent 自己，它用的是自己那一套。

你在 Settings > LLM 設好的模型組合，對 ACP agent 也沒有作用。

簡單講：想省錢、想用熟悉的 agent，接 ACP；想把 OpenHands 的功能用滿，用原生 agent。兩種可以並存，不同對話選不同 agent 就好。

限制與風險

安全邊界不要假設 OpenHands 會幫你管。 ACP agent 用的是它自己的工具和規則，OpenHands 這邊的很多設定不會套用到它身上。第一次接的時候，一樣拿測試專案，看清楚它會跑哪些指令、改哪些檔案。

同一個容器裡，同一家的 agent 不要同時開好幾個對話。 官方列為已知問題：同時跑多個 Claude Code 對話時，可能互搶登入狀態，目前還沒修好。

登入憑證等於你的帳號。 Docker 版要提供的那兩個值，外流就等於帳號外流，只放在 Secrets 裡，不要分享設定檔。

npm 和桌面版預設沒有沙箱。 這點跟用 OpenHands 原生 agent 一樣，agent 能碰到你整台電腦的檔案，詳見 Agent Canvas 安裝教學的沙箱那段。

我會這樣建議

如果你已經每天在用 Claude Code 或 Codex，接進 OpenHands 的成本很低：裝好 Agent Canvas，在設定精靈第一步選它，就能開始用，不用多付錢。值得花半小時試試看，在同一個畫面裡管理好幾個 agent 的對話，到底對你有沒有幫助。

如果你還沒有任何訂閱，就不用為了這個功能去買。先用 OpenHands 原生 agent 搭一個便宜的模型，熟悉之後再決定。

想把多個 agent 的工作方式整理得更有條理，可以接著看 Claude、Codex 與 Skills 工作流；只想用 Codex 的人，Codex 桌面版也是另一個選擇。

資料來源

本文依 OpenHands 官方文件整理。Agent Canvas 目前還在 beta，ACP 支援的 agent、設定位置與已知問題都可能變動，使用前請再確認官方頁面；各家訂閱的使用範圍以各自的服務條款為準。

https://docs.openhands.dev/openhands/usage/agent-canvas/acp-agents
https://docs.openhands.dev/sdk/guides/agent-acp
https://docs.openhands.dev/openhands/usage/agent-canvas/first-time-setup
https://github.com/OpenHands/OpenHands