OpenCode：Claude Code 的完美开源替代？保姆级安装与避坑指南

最近 OpenCode 在開發者圈子裡傳得很火。

如果你用過 Claude Code，應該知道它的幾個痛點：帳號容易被封、國內訪問慢、Token 費用貴。OpenCode 號稱能解決這些問題，而且完全開源。

我花了兩天時間測試，發現它確實有點東西。

为什么你需要 OpenCode？

简单来说，OpenCode 就是一个开源版、本地化、且无厂商锁定的 Claude Code。

它复刻了 Claude Code 的核心体验——基于终端的 AI 编程 Agent，但解决了最大的痛点：自由。

特性	Claude Code	OpenCode
開源狀態	閉源	✅ 100% 開源 (MIT)
模型支持	僅限 Claude	✅ OpenAI, Gemini, Claude, Local (Ollama)
部署方式	雲端依賴強	✅ 支持完全本地運行
界面	僅命令行	✅ 命令行 (TUI) + 桌面 App
費用	訂閱/Token	✅ 免費 (取決於你連接的模型)

快速开始：安装避坑指南

虽然官方文档写得很简单，但实测下来，尤其是在 Windows 环境下，坑点不少。我帮大家踩了一遍雷，总结了最稳的安装路径。

macOS / Linux 用户

你们是幸福的，直接使用 Homebrew 或者 Curl 即可一键搞定。

# 推荐方式：始终保持最新
brew install anomalyco/tap/opencode

# 或者使用 Curl
curl -fsSL https://opencode.ai/install | bash

Windows 用户（重点！）

Windows 用户请注意，直接使用 npm 安装可能会遇到各种黑屏或权限问题。建议使用 Chocolatey (choco)，并且必须注意权限。

第一步：准备 Chocolatey 环境

如果你还没有安装 choco，请以管理员身份打开 PowerShell，执行以下命令：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

第二步：安装 OpenCode

继续在管理员权限的 PowerShell 中执行：

choco install opencode

⚠️ 注意：安装过程中如果提示需要 License 同意，请输入 A (All) 确认。如果安装后运行报错，尝试在普通用户权限下再运行一次 opencode -y 进行初始化。

核心配置：连接你的 AI 大脑

OpenCode 强大的地方在于它的 provider 机制。你不再被绑定在 Anthropic 一棵树上。

启动 OpenCode 后，输入 /connect 即可进入配置界面。或者你可以直接编辑配置文件（通常在 ~/.config/opencode/config.json）。

推薦配置示例

如果你想用目前性價比最高的 DeepSeek 或者 Gemini，可以這樣配置：

{
  "providers": {
    "apiyi": {
      "apiKey": "sk-xxxxxx",
      "baseURL": "https://api.deepseek.com/v1",
      "models": [
        "deepseek-coder-v2",
        "gemini-1.5-pro"
      ]
    }
  },
  "defaultProvider": "apiyi",
  "defaultModel": "deepseek-coder-v2"
}

實際體驗

先說結論：能用，但還不夠穩定。

做得好的地方

1. TUI 界面：用 Bubble Tea 做的終端界面比 Claude Code 的黑底白字好看多了
2. 桌面版：不習慣命令行的人可以用可視化界面
3. Plan/Build 模式切換：按 Tab 鍵就能切換，Plan 模式只讀不寫，適合代碼審查

槽點

1. 兼容性問題：官方說兼容 .claude 配置，但 Windows 下經常讀不到
2. 權限管理：Windows 下動不動就「拒絕訪問」

👨‍💻 開發者建議

如果你是一個喜歡折騰的開發者，OpenCode 絕對值得一試。它就像是一個「開放版的 Cursor 終端」。

我的建議是：

1. 搭配 MCP 使用：OpenCode 支持 MCP (Model Context Protocol)。你可以編寫一個簡單的 MCP Server 來連接你的本地數據庫或文檔，讓 AI 真的「讀懂」你的業務。
2. 別急著卸載 Claude Code：目前 OpenCode 還在快速迭代中（Beta 階段），保留原版作為備用是明智的選擇。

總結

OpenCode 的出現證明了一件事：AI 開發工具的未來一定是開源和模塊化的。 我們不需要另一個圍牆花園，我們需要的是一把趁手的、可以自由組裝的瑞士軍刀。

趁著現在還沒收費（雖說是開源，但桌面版未來難說），趕緊下載體驗一下吧！

參考資料 / References:

• OpenCode GitHub Repository
• OpenCode Beginner Guide