安裝
Coppice Beta 以桌面應用程式推出。不需要 Docker,不需要伺服器,也不需要 Coppice 帳號。
支援的平台
| 平台 | 套件 |
|---|---|
| macOS (Apple Silicon) | .dmg |
| Linux (x64) | .deb |
本次 Beta 沒有 Windows 應用。如果你用的是 Windows 11,請看 Windows 11(經 WSL)。
下載
所有版本也都可以在 GitHub Releases 獲取。
更新
Coppice 會在後台檢查新版本。如果想關閉,開啟 System → Updates(系統 → 更新),關掉 Automatic updates(自動更新)。更新後,你的看板和設定都會保留。
- macOS: Coppice 會替你下載更新。在橫幅中選擇 Restart to update(重新啟動以更新),或者在你下次結束 Coppice 時自動安裝。
- Linux: 安裝
.deb時會新增 Coppice 的軟件源,所以新版本會和其他更新一起出現在「軟件更新器」裏;也可以執行sudo apt update && sudo apt upgrade。
Windows 11(經 WSL)
Linux x64 版本應該可以經 WSL 在 Windows 11 上執行,但我們還沒有測試過。如果你試了,歡迎告訴我們結果。
你需要 Windows 11,因為較早的 Windows 10 版本無法顯示 Linux 應用視窗。目前暫不支援 Arm 架構的 Windows 電腦。
-
以管理員身份開啟 PowerShell,執行
wsl --install。這會安裝 Ubuntu。按提示重啟,然後完成 Ubuntu 使用者的設定。 -
仍以管理員身份在 PowerShell 中更新 WSL,讓 Linux 應用視窗能顯示在 Windows 桌面上:
wsl --update wsl --shutdown -
從「開始」選單開啟 Ubuntu。後面的步驟都在 Ubuntu 中完成。下載並安裝 Linux x64 的
.deb。把<version>換成 GitHub Releases 上的最新版本號:cd ~ wget https://github.com/fertile-org/coppice/releases/download/v<version>/Coppice-<version>-linux-amd64.deb sudo apt install ./Coppice-<version>-linux-amd64.deb請用
apt,不要用dpkg -i。apt會順帶安裝 Coppice 需要的依賴。以後要更新 Coppice,執行
sudo apt update && sudo apt upgrade。你的看板和設定都會保留。 -
在 Ubuntu 中安裝你要用的代理 CLI(Claude Code、Codex、Cursor、OpenCode、Kilo Code、GitHub Copilot、Qwen Code、Kimi Code、Grok),並在 Ubuntu 裏登入這些 CLI 和 git。
-
從 Windows「開始」選單(Ubuntu 分組下)啟動 Coppice,或在 Ubuntu 中執行
coppice。如果某個 CLI 顯示 Not on your PATH,請在 Ubuntu 中執行
coppice來啟動 Coppice。
WSL 會把 Windows 的 PATH 加到 Ubuntu 中,所以 Coppice 可能會找到某個 CLI 的 Windows 版本。開啟 System → Connectors(系統 → 連接器),查看每個連接器的 CLI 路徑。如果路徑以 /mnt/c/ 開頭,請在 Ubuntu 中安裝該 CLI。
把倉庫放在 Linux 主目錄下,例如 ~/code/my-app,不要放在 /mnt/c/ 下。跨過這道邊界存取時,Git 和檔案讀寫都會慢很多。資料夾選擇器顯示的是 Linux 路徑。
首次執行
-
安裝並開啟 Coppice。
-
選擇你磁碟上已有的一個本地 git 倉庫。
-
連線你的代理 CLI。 建立代理時選擇你的代理 CLI,Coppice 就會啟用它。每個 CLI 都會顯示狀態:Ready(就緒)、Found, not signed in(已找到,未登入)或 Not on your PATH(不在 PATH 中)。請先像平常一樣在終端裏登入該 CLI。
Kilo Code、GitHub Copilot、Qwen Code 和 Kimi Code 顯示為 Installed(例如 Kilo Code — Installed)。System → Connectors 中還會提示:“Coppice can’t check this sign-in without using your plan. A run will show an error if you’re signed out.”(不耗用你的訂閱,Coppice 就無法檢查這項登入;如果你已登出,執行時會報錯。)
以後要關閉某個連接器,可以在 System → Connectors 中使用開關,或在 Coppice 的
config.toml中為它設定enabled = false:- macOS:
~/Library/Application Support/Coppice/config.toml - Linux:
~/.config/Coppice/config.toml
- macOS:
-
建立一個工單(或批准一個建議的工單),把它移到 Ready。代理會帶着它依次經過 In Progress、In Review 和 In QA,然後等待你進行 Human Review(人工審查)。
系統要求
- 一個你有寫許可權的本地 git 倉庫(Coppice 使用隔離的 worktree)
- 至少安裝一個受支援的代理 CLI,並按該工具的常規方式完成登入認證
故障排查
如果應用無法啟動,或者代理一直不接工單,請查看工單上的即時終端和常見問題。如需從原始碼構建,請看倉庫中的貢獻者文件。