RchGrav/claudebox

ClaudeBox – 用於 Anthropic Claude Code 的 Docker 開發環境

這是什麼

• 一個命令列工具，可設定一個預先載入 Claude Code CLI（Anthropic 的 AI 編碼助手）和一套開發工具的隔離 Docker 容器。
• 每個專案都有自己的 Docker 映像檔、Python 虛擬環境、防火牆白名單以及持久化的 Claude 驗證/歷史記錄，因此您可以並行處理多個專案而不會產生交叉污染。

主要功能

功能	您將獲得
容器化 Claude	在基於 Debian 的 Docker 映像檔中執行 Claude Code，若缺少 Docker 則會自動安裝。
開發設定檔	一鍵安裝語言堆疊（C/C++、Python、Rust、Go、Java、JavaScript 等）以及專業工具集（OpenWRT、DevOps、安全、資料科學等）。
專案隔離	每個專案（稱為 slots）都有獨立的 Docker 映像檔、驗證檔案、Shell 歷史記錄和工具設定。
持久化配置	設定檔、已安裝套件和 Python uv 虛擬環境在容器重啟後依然存在。
多實例支援	同時在不同的專案目錄中啟動獨立的 Claude 工作階段。
安全控制	專案專屬的防火牆白名單；可選的 --enable-sudo、--disable-firewall 或 --dangerously-skip-permissions 旗標。
豐富的開發體驗	GitHub CLI、Delta、fzf、Powerline 風格的 Zsh，以及內建用於多窗格工作流程的 tmux 整合。
剪貼簿橋接 (macOS)	可選服務，可在主機剪貼簿與容器之間轉發影像/文字（限制為 20 MiB 影像 / 1 MiB 文字）。
任務引擎	Claude 內部的簡單 /task 指令，用於拆解並迭代程式碼生成任務。

安裝 (快速入門)

# 取得自解壓縮安裝程式
wget https://github.com/RchGrav/claudebox/releases/latest/download/claudebox.run
chmod +x claudebox.run
./claudebox.run          # 解壓縮至 ~/.claudebox/source/ 並連結至 ~/.local/bin/claudebox

安裝程式會在首次執行時檢查 Docker 並將其設定為非 root 使用。

如果您偏好手動存檔，請從 Releases 頁面下載 tarball，解壓縮後執行 ./main.sh 來建立符號連結。

典型工作流程

# 在專案目錄內
claudebox create               # 建立一個新的「插槽」（持久化 Claude 工作階段）
claudebox slots                # 列出現有插槽及其狀態
claudebox add python           # 新增開發設定檔（選用）
claudebox slot 1               # 連接到插槽 1 – 您將進入一個準備好 Claude 的 Shell

您可以使用另一個 claudebox create 在相同或不同的專案中啟動另一個插槽。不帶參數執行 claudebox 會自動選擇一個非活動的插槽。

管理設定檔

claudebox profiles                 # 列出所有可用設定檔及其說明
claudebox profile                 # 新增/移除設定檔的互動式選單
claudebox profile status          # 查看目前專案啟用了哪些設定檔
claudebox profile rust go         # 為此專案安裝 Rust 和 Go 工具鏈

設定檔會快取在專案的 Docker 映像檔中，因此安裝新設定檔只會觸發該映像檔的重建。

以自訂旗標執行 Claude

claudebox --model opus -c          # 以 *opus* 模型和程式碼生成模式啟動 Claude
claudebox save --enable-sudo       # 記住此旗標，以便未來的執行繼承它

儲存的旗標會儲存在本地，並自動套用到後續的 claudebox 指令。

剪貼簿支援 (僅限 macOS)

claudebox --clipboard               # 啟動一個可以讀取/寫入主機剪貼簿的工作階段

此橋接會建立一個繫結到 localhost 的短效 HTTP 監聽器；工作階段權杖作為密鑰。基於安全考量，預設為停用。

清理與維護

• claudebox clean – 互動式選單，用於刪除設定檔、專案資料、Docker 映像檔，或目前專案的所有內容。
• claudebox clean --containers / --image / --cache / --volumes – 全域 Docker 清理選項。
• claudebox rebuild – 強制重新建置專案的 Docker 映像檔。

資料存放位置

• ~/.claudebox/source/ – 已安裝的指令碼。
• ~/.claudebox/projects/<project-id>/ – 專案狀態（設定檔、Docker 映像檔標籤、防火牆規則、Python venv 等）。
• ~/.claudebox/projects/<project-id>/<slot-id>/.claude/ – Claude 驗證權杖、工作階段歷史記錄和設定檔。
• 主機工作區以讀寫模式掛載在容器內的 /workspace；主機的 ~/.gitconfig 以唯讀模式掛載。

適用對象

• 希望為 Claude Code 建立可重現、隔離環境，且不想手動設定 Docker、語言執行環境或安全設定的開發者。
• 需要進行專案級沙盒隔離（不同的 Python 版本、獨立的網路白名單等），同時共享單一主機的團隊。
• 任何尋求「隨插即用」AI 輔助編碼設定，且能鏡像完整開發工作站的人。

授權

• MIT (請參閱 LICENSE)。

---

以上所有資訊均直接取自儲存庫的 README；未推論出任何額外功能。