coi

coi 概覽

這是什麼

Coi (Code on Incus) 讓你的 AI 編碼工具（Claude Code、Codex、opencode、pi、omp）在獨立的 Linux 系統容器中執行：一個完整的作業系統容器，具備 root 權限、systemd、Docker，以及自由安裝任何軟體的能力。代理程式就像在真實伺服器上運作，但無法觸及你的主機、無法看到你的憑證，如果它做出危險行為，coi 會自動暫停或終止容器。

主要功能

• 真實機器，不是封閉的盒子 — Incus 系統容器提供代理完整的作業系統：root、systemd、原生 Docker、套件管理器、服務。
• 正確的檔案所有權 — 工作區的編輯內容會以你的身份儲存在主機上，無需 chown 的繁瑣步驟。
• 憑證留在家中 — SSH 金鑰、令牌、.env 以及主機環境變數除非你明確掛載或轉發，否則絕不會進入容器，且 coi shell 在啟動時會列出所有授權項目。
• 主動防禦 — 核心層級監控即時偵測反向 shell、C2、資料外洩及 DNS 隧道，並在 HIGH 等級自動暫停，CRITICAL 等級自動終止。
• 網路隔離 — 使用 nftables 進行出口流量控制，提供三種模式（開放、限制、允許清單）、DNS 固定以及每台主機的連接埠範圍限制。
• 平行代理 — 每個專案可有多個插槽，各自擁有獨立家目錄，彼此隔離。
• 設定檔 — 可重複使用的命名設定（映像檔、工具、資源限制、網路、建置腳本、代理指令），透過單一旗標套用，並支援繼承。

使用情境

• 你執行 AI 編碼代理，希望它們擁有完整的機器存取權（root、Docker、套件管理器、服務），同時不危及主機安全。
• 你想在代理做出可疑行為時立即得知，而不是事後才發現。
• 你同時執行多個代理，需要它們彼此隔離。
• 你需要能跨重啟持續存在的開發環境，而不是每次都要重新設定的臨時容器。
• 你重視憑證安全，不希望它們進入代理控制的環境。

快速開始

bash # 1. 安裝 curl -fsSL https://raw.githubusercontent.com/coipond/coi/master/install.sh | bash # 2. 建立基礎映像檔（僅首次需要，約 5-10 分鐘） coi build # 3. 從任何專案目錄開始編碼 cd your-project coi shell

授權與價格

授權為 MIT。此專案為開放原始碼。

內容整理自該專案公開的 README 與儲存庫資訊。