返回博客
2026-03-27更新於 2026-11-15
Toolsify Editorial Team
Developer Tools

OpenCode:為程式碼儲存庫設定 AI 程式設計代理

AI CodingOpen SourceDeveloper ToolsCode AssistantOpenCodeopencode the open source ai coding agent
Sponsored

OpenCode 是開源程式設計代理,提供終端機、桌面和網頁介面。實際效果取決於連接的模型,以及提供給它的儲存庫背景資訊。本文依據 2026 年 11 月 15 日查核的 v2 文件;舊教學可能採用不同的設定欄位。安裝指南列出支援的套件和 /connect 提供商連線指令。

連接儲存庫與模型提供商

安裝適合作業系統的版本,進入專案目錄並執行 opencode。使用 /connect 設定帳號可存取的提供商。用戶端能正常運作,不代表模型呼叫免費:仍須遵守提供商的計費和資料處理規則。

在儲存庫建立 opencode.jsonc,加入下方 schema。設定參考解釋專案、全域和受管理設定的關係。如果設定沒有生效,應檢查這些層級;受管理設定可以覆寫專案選項。不要將憑證寫入會提交的檔案。

明確訂定指令執行界線

下方 v2 範例要求執行 shell 指令前確認,禁止推送,並在存取專案外目錄前詢問:

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "git push *", "effect": "deny" },
    { "action": "external_directory", "resource": "*", "effect": "ask" }
  ]
}

最後一條符合的權限規則生效,也須檢查個別代理的覆寫規則。這些是工具權限,並非作業系統層級的沙箱。權限參考說明動作名稱和比對方式。

調查一個具體缺陷

遇到表單重複送出,可以先交給 Plan:「追蹤送出處理函式與網路請求,說明為何點擊一次產生兩次請求,並提出最小修正。」Plan 避免修改一般專案檔案,但 shell 指令仍受權限控制。Build 負責實作修改,差異詳見代理參考。

將定位到的檔案和驗收要求交給 Build:每次點擊只發送一個請求,保留現有驗證,並加入重複送出的迴歸檢查。要求沿用既有測試框架,回報實際指令輸出。解釋聽來合理,並不代表程式正確。

採用前檢查結果

查看 git diff,執行相關測試和儲存庫要求的檢查,審查意外出現的相依套件或產生檔案變更。保留乾淨的 Git 檢查點:檔案系統復原無法逆轉遠端操作或資料庫修改。使用同一缺陷比較不同提供商,記錄審查時間、剩餘失敗和實際呼叫費用。這才是可用的選型紀錄,無須杜撰評測分數,也不能假設所有模型行為一致。

Sponsored