Appearance
开发容器（Dev Container）
Claude Code 官方参考 devcontainer 提供开箱即用的隔离开发环境：Node.js 20 基础镜像、自定义防火墙（只允许 npm/GitHub/Claude API 等白名单域出站）、VS Code 预配置扩展、ZSH 增强工具链。容器隔离使 --dangerously-skip-permissions 可安全用于无人值守自动化。适合团队统一入职环境、镜像 CI/CD、以及隔离不同客户项目的代码和凭据。
Claude Code 提供参考 devcontainer 配置 和配套 Dockerfile，开箱即用，也可按需自定义。
该 devcontainer 兼容 VS Code Dev Containers 扩展 及类似工具。容器的隔离和防火墙规则使其可以安全运行 claude --dangerously-skip-permissions 跳过权限提示，适合无人值守操作。
安全提示：devcontainer 提供实质性保护，但无法完全抵御所有攻击。使用
--dangerously-skip-permissions时，恶意项目仍可能泄露容器内可访问的内容（包括 Claude Code 凭据）。建议仅在开发受信任的仓库时使用，并持续监控 Claude 的活动。
核心特性
| 特性 | 说明 |
|---|---|
| 生产就绪的 Node.js | 基于 Node.js 20，包含必要的开发依赖 |
| 安全设计 | 自定义防火墙，限制出站连接仅到白名单域（npm、GitHub、Claude API 等） |
| 开发者工具 | 包含 git、ZSH（带生产力增强）、fzf 等 |
| VS Code 集成 | 预配置扩展和优化的编辑器设置 |
| 会话持久化 | 容器重启间保留命令历史和配置 |
| 跨平台 | 兼容 macOS、Windows 和 Linux |
4 步快速开始
- 安装 VS Code 和 Dev Containers 扩展
- 克隆 Claude Code 参考实现 仓库
- 用 VS Code 打开仓库
- 出现提示时点击 Reopen in Container（或命令面板：Cmd+Shift+P → "Dev Containers: Reopen in Container"）
容器构建完成后，在 VS Code 中按 Ctrl+` 打开终端，运行 claude 完成认证并开始首次会话。Claude Code 已预装，你的项目文件挂载在容器中，Claude 写入的代码直接出现在本地仓库。
配置文件说明
Devcontainer 由三个主要文件组成：
| 文件 | 说明 |
|---|---|
| devcontainer.json | 控制容器设置、扩展和卷挂载 |
| Dockerfile | 定义容器镜像和已安装工具 |
| init-firewall.sh | 建立网络安全规则 |
安全特性
容器采用多层安全策略：
- 精确访问控制：出站连接仅限白名单域（npm 注册表、GitHub、Claude API 等）
- 允许的出站连接：防火墙允许出站 DNS 和 SSH 连接
- 默认拒绝策略：阻止所有其他外部网络访问
- 启动验证：容器初始化时自动验证防火墙规则
- 隔离：与主系统隔离的安全开发环境
自定义选项
配置设计为易于适配：
- 根据工作流添加或删除 VS Code 扩展
- 针对不同硬件调整资源分配
- 修改网络访问权限
- 自定义 Shell 配置和开发工具
典型使用场景
安全的客户项目隔离
用不同的 devcontainer 实例隔离不同客户项目，确保代码和凭据不跨环境混用。
团队统一入职
新成员开箱即用——几分钟内获得完整配置的开发环境，所有工具和设置均已预装。
CI/CD 环境对齐
在 CI/CD 流水线中复用 devcontainer 配置，确保开发和生产环境一致，消除"在我机器上可以运行"的问题。
相关文档
常见问题
Q: devcontainer 中可以安全使用 --dangerously-skip-permissions 吗？
可以，这正是参考 devcontainer 的设计目的之一。容器隔离和防火墙规则大幅降低了风险，适合无人值守的自动化任务。但注意仍应只在受信任的仓库中使用，因为恶意代码理论上仍可访问容器内的凭据。
Q: devcontainer 支持哪些操作系统？
参考 devcontainer 兼容 macOS、Windows 和 Linux 上的 VS Code Dev Containers 扩展，以及兼容同一规范的其他工具。
Q: 如何添加自定义工具或扩展？
修改 devcontainer.json（添加 VS Code 扩展）或 Dockerfile（添加系统工具），然后重建容器。网络访问白名单在 init-firewall.sh 中配置。