前言

如果你最近有在用 Claude Code，但每個月訂閱費讓你肉痛，或者你只是想在 Claude Code 的新功能上實驗看看，又不想花 Opus 的錢——那麼這篇文章就是為你準備的。

OpenCode Go 是 OpenCode 平台提供的付費 API 服務，支援超過 75 個 LLM 供應商。它的亮點之一是：部分模型支援 Anthropic 的 Messages API（/v1/messages），這意味著你可以把它接上 Claude Code，用更低的成本體驗 Claude Code 的完整功能。

本文綜合了多篇實測文章與社群經驗，整理出一份完整的入門指南，包含模型選擇、設定檔撰寫、兩個經典坑位，以及除錯技巧。

- 廣告 -

什麼是 OpenCode Go？

OpenCode 是一個開源（MIT 授權）的 AI 程式碼代理（Coding Agent），可以在終端機、桌面應用或 IDE（VS Code / Cursor）中使用。它與 Claude Code 最大的不同在於模型無關——Claude Code 綁定 Anthropic，而 OpenCode 可以接 75+ 個後端。

OpenCode Go 則是 OpenCode 自家的付費 API 服務，提供一組經過優化的模型端點。它的定位很明確：用合理的價格，提供穩定的程式碼助手體驗。

支援 Anthropic Messages API 的模型

不是所有 OpenCode Go 模型都支援 /v1/messages。根據 2026 年 7 月的最新資料，以下模型可以與 Claude Code 無縫搭配：

模型模型 ID
MiniMax M3minimax-m3
MiniMax M2.7minimax-m2.7
MiniMax M2.5minimax-m2.5
Qwen3.7 Maxqwen3.7-max
Qwen3.7 Plusqwen3.7-plus
Qwen3.6 Plusqwen3.6-plus

小提醒： 這些模型不等同於 Anthropic 原生的 Opus / Sonnet / Haiku。如果你用 Opus 幾個月前的表現來衡量，它們其實已經差不多了；但如果你期望它們在 2026 年中打平最新的 Opus，那可能要多點耐心。

設定步驟：三行搞定

最簡單的方式是直接寫入 Claude Code 的設定檔 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-你的 OpenCode Go API key",
    "ANTHROPIC_BASE_URL": "https://opencode.ai/zen/go",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus"
  },
  "model": "opus"
}

重點說明：

  • ANTHROPIC_API_KEY：你的 OpenCode Go API Key（在 OpenCode 控制台取得）
  • ANTHROPIC_BASE_URL：只寫域名，不要加 /v1（這是第一個坑，稍後詳述）
  • ANTHROPIC_DEFAULT_*_MODEL：把 Claude 的三級模型名稱對應到 OpenCode Go 的模型 ID
  • "model": "opus"：告訴 Claude Code 你預設想要 Opus 級別的能力

兩個容易踩的配置坑

坑一：BASE_URL 多打了 /v1

Claude Code 在發出請求時，會自動在 ANTHROPIC_BASE_URL 後面加上 /v1/messages。如果你設定的 Base URL 已經包含 /v1，最終請求的 URL 就會變成：

https://opencode.ai/zen/go/v1/v1/messages

雙重 /v1 導致 404，但 Claude Code 回報的錯誤訊息卻是「Model does not exist」——這會讓你以為是模型 ID 寫錯，然後換了一個又一個模型，結果還是一樣报错。

正確寫法：

"ANTHROPIC_BASE_URL": "https://opencode.ai/zen/go"

錯誤寫法：

"ANTHROPIC_BASE_URL": "https://opencode.ai/zen/go/v1"

坑二：認證標頭用錯變數

OpenCode Go 要求使用 x-api-key 這個 Header 來傳遞 API Key。如果你設定了 ANTHROPIC_AUTH_TOKEN，Claude Code 會送出 Authorization: Bearer 標頭，OpenCode Go 會直接回傳 401：

MissingAPIkey

正確寫法：

"ANTHROPIC_API_KEY": "sk-你的 OpenCode Go API key"

錯誤寫法：

"ANTHROPIC_AUTH_TOKEN": "sk-你的 OpenCode Go API key"

進階：用 ocgo 自動化代理

如果你不想手動設定環境變數，可以試試社群開發的 ocgo（OpenCode Go CLI）工具。這是一個輕量級的 Go 程式，扮演 Ollama 風格的本地代理：

# 安裝（Homebrew）
brew tap emanuelcasco/tap
brew install ocgo

# 設定 API Key
ocgo setup --api-key sk-opencode-your-key

# 啟動 Claude Code（自動代理）
ocgo launch claude --model kimi-k2.6

ocgo 會在本地 127.0.0.1:3456 啟動一個 Anthropic 相容的代理，自動把 Claude Code 的 /v1/messages 請求轉譯成 OpenCode Go 需要的格式。對於想「一行命令跑起來」的開發者來說，這是個不錯的選擇。

除錯技巧：抓真實請求

Claude Code 的錯誤訊息通常很籠統，遇到問題時的第一反應不應該是換模型，而是看真正的網路請求。

使用 --debug 參數：

claude -p "hi" --debug 2> debug.log

這會把完整的 URL、狀態碼、回應內容都輸出到 debug.log。透過它你可以快速判斷：

  • 是路徑錯誤（404）？
  • 是認證問題（401）？
  • 還是模型確實不存在（400）？

成本比較與實用建議

維度Claude Code + 原生 OpusClaude Code + OpenCode Go
月費~$200（Claude 訂閱）~$10-30（OpenCode Go 方案）
模型能力頂尖中上（Opus 幾個月前的水準）
設定難度零低（注意兩個坑即可）
適合場景複雜推理、高品質輸出日常編碼、快速迭代

我的建議：

  1. 日常編碼任務（CRUD、重構、測試寫法）：用 OpenCode Go 完全夠用，省下的錢可以拿去喝幾杯咖啡 ☕
  2. 高難度推理（系統架構設計、複雜演算法）：還是用原生 Opus
  3. 混合策略：兩者都裝，按任務切換——這是最聰明的做法

小結

OpenCode Go 接入 Claude Code 的核心就兩件事：不要把 /v1 寫進 BASE_URL，以及用 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN。記住這兩點，剩下的就是享受更便宜的 AI 程式碼助手體驗了。

如果你正在尋找 Claude Code 的平價替代方案，或者想在實驗環境裡測試新功能而不燒 Opus 的錢，OpenCode Go 值得試試看。

本文綜合自 Sanjeev 的實測文章 、Kristof Kovacs 的設定分享 、ocgo 專案 ，以及 DeepInfra 的 OpenCode 比較指南。

- 廣告 -