Skip to main content
開發容器（或 dev container）讓您定義一個相同的隔離環境，您的團隊中的每位工程師都可以執行。安裝 Claude Code 在該容器中後，Claude 執行的命令會在容器內執行，而不是在主機上執行，同時對您的專案檔案的編輯會在您工作時出現在本地儲存庫中。 本頁涵蓋在開發容器中安裝 Claude Code，然後是一組獨立的配置主題：在重新構建時保持身份驗證、強制執行組織政策、限制網路出站流量，以及無需權限提示即可執行。請閱讀與您的設定相符的主題。
雖然開發容器提供了大量保護，但沒有任何系統完全免疫所有攻擊。 當使用 --dangerously-skip-permissions 執行時，開發容器不會阻止惡意專案從容器內可存取的任何內容（包括儲存在 ~/.claude 中的 Claude Code 認證）進行資料外洩。 僅在使用受信任的儲存庫進行開發時使用開發容器，並監控 Claude 的活動。 避免將主機祕密（例如 ~/.ssh 或雲端認證檔案）掛載到容器中；優先使用儲存庫範圍或短期有效的令牌。
顯示主機上的編輯器連接到 Docker 開發容器的圖表。Claude Code、終端和構建工具在容器內執行。主機儲存庫被綁定掛載到容器中作為工作區。顯示主機上的編輯器連接到 Docker 開發容器的圖表。Claude Code、終端和構建工具在容器內執行。主機儲存庫被綁定掛載到容器中作為工作區。開發容器作為 Docker 容器執行，可以在您的機器上或雲端主機（例如 GitHub Codespaces）上執行。支援 Dev Containers 規範的編輯器（例如 VS Code、GitHub Codespaces、JetBrains IDE 或 Cursor）連接到該容器：您在編輯器中照常瀏覽和編輯檔案，但整合終端、語言伺服器和構建工具都在容器內執行，而不是在您的主機上。不支援開發容器的編輯器（例如純 Vim）不是此工作流程的一部分。Claude Code 在容器內執行，因此它看到與您的專案工具鏈其餘部分相同的檔案、依賴項和工具。在 VS Code 中，您可以使用 Claude Code 擴充功能面板 或在整合終端中執行 claude；兩者都在容器內執行並共享相同的 ~/.claude 配置。

​
在開發容器中新增 Claude Code

Claude Code 透過 Claude Code Dev Container Feature 安裝到任何開發容器中。 這些設定適用於任何支援 Dev Containers 規範的工具，例如 VS Code、GitHub Codespaces 或 JetBrains IDE。下面的步驟以 VS Code 為例。 當您在 VS Code 或 Codespaces 中開啟容器時，該功能還會新增 Claude Code VS Code 擴充功能；其他編輯器會忽略該部分。
初次接觸開發容器？VS Code Dev Containers 教程會逐步介紹安裝 Docker、擴充功能和開啟您的第一個容器。如需更完整的強化示例（包含防火牆和持久磁碟區），請參閱試用參考容器。
1

建立或更新 devcontainer.json

將以下內容儲存為儲存庫中的 .devcontainer/devcontainer.json，或將 features 區塊新增到您現有的檔案中。末尾的版本標籤（例如 :1.0）會固定功能的安裝指令碼，而不是 Claude Code 版本。該功能會安裝最新的 Claude Code，Claude Code 預設會在容器內自動更新。若要固定 CLI 版本或停用自動更新，請參閱強制執行組織政策。
.devcontainer/devcontainer.json
將 image 行替換為您的專案的基礎映像，或如果您現有的檔案使用 Dockerfile，則將其移除。Claude Code 功能會在基礎映像未提供 Node.js 時自行安裝。如果該安裝失敗且構建停止並顯示 Failed to install Node.js and npm，請將 "ghcr.io/devcontainers/features/node:1": {} 新增到上述 features 區塊中 Claude Code 功能的上方，然後重新構建。
2