預配置的 devcontainer 設置 與 VS Code 的 Remote - Containers 擴展和類似工具無縫協作。

容器的增強安全措施(隔離和防火牆規則)允許您運行 claude --dangerously-skip-permissions 來繞過權限提示以進行無人值守操作。我們已包含一個 參考實現,您可以根據需要進行自定義。

雖然 devcontainer 提供了實質性的保護,但沒有系統能完全免疫所有攻擊。始終保持良好的安全實踐並監控 Claude 的活動。

主要功能

  • 生產就緒的 Node.js:基於 Node.js 20 構建,包含必要的開發依賴項
  • 安全設計:自定義防火牆,僅限制網絡訪問必要的服務
  • 開發者友好工具:包括 git、ZSH 與生產力增強功能、fzf 等
  • 無縫 VS Code 集成:預配置的擴展和優化設置
  • 會話持久性:在容器重啟之間保留命令歷史和配置
  • 隨處可用:與 macOS、Windows 和 Linux 開發環境兼容

4 步開始使用

  1. 安裝 VS Code 和 Remote - Containers 擴展
  2. 克隆 Claude Code 參考實現 存儲庫
  3. 在 VS Code 中打開存儲庫
  4. 當提示時,點擊「在容器中重新打開」(或使用命令面板:Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

配置分解

devcontainer 設置由三個主要組件組成:

安全功能

容器通過其防火牆配置實現多層安全方法:

  • 精確訪問控制:僅限制出站連接到白名單域(npm 註冊表、GitHub、Anthropic API 等)
  • 默認拒絕策略:阻止所有其他外部網絡訪問
  • 啟動驗證:在容器初始化時驗證防火牆規則
  • 隔離:創建與主系統分離的安全開發環境

自定義選項

devcontainer 配置設計為可適應您的需求:

  • 根據您的工作流程添加或移除 VS Code 擴展
  • 為不同硬件環境修改資源分配
  • 調整網絡訪問權限
  • 自定義 shell 配置和開發者工具

示例用例

安全客戶工作

使用 devcontainers 隔離不同的客戶項目,確保代碼和憑據永遠不會在環境之間混合。

團隊入職

新團隊成員可以在幾分鐘內獲得完全配置的開發環境,所有必要的工具和設置都已預安裝。

一致的 CI/CD 環境

在 CI/CD 管道中鏡像您的 devcontainer 配置,以確保開發和生產環境匹配。

相關資源