CLI claudebox 把Claude Code装进Docker的可复现开发环境

把 Claude Code 真正用进项目，往往会卡在环境：不同项目要不同的 Node/Python 版本、不同的全局配置、不同的 API key 作用域，换台机器就全乱。ClaudeBox 的思路是“把 Claude Code 装进 Docker”——一个完全容器化、可复现的开发环境，配好开发档案（profile）后，任何机器上拉起都是同一套环境。

项目基本信息

一、项目介绍

RchGrav/claudebox 自称“终极 Claude Code Docker 开发环境”。它不是一个新模型，而是一套预配置的容器与启动器：你用 claudebox create 开一个“槽位（slot）”，里面已经装好 Claude Code 与若干开发档案，认证一次后即可在隔离环境里跑 AI 编程助手。最新版还修了 macOS 可靠性与剪贴板相关问题。

二、核心优势

1. 可复现：环境完全容器化，团队成员拿到的是一致的开发环境。
2. 隔离：每个 slot 独立，项目之间互不污染。
3. 轻装：提供自解压安装器（.run）与归档两种安装方式。
4. 多档案：可给 slot 追加 python 等开发档案，按需装配。
5. 跨平台：Docker 本身跨平台，宿主机 Windows / macOS / Linux 皆可。

三、适用场景

• 团队统一 AI 编程环境，避免“在我机器上能跑”。
• 临时给外包/协作者开一个干净、受限的 Claude Code 环境。
• 在服务器上长期托管多个 Claude Code 工作槽。

四、安装教程

方式一，自解压安装器（推荐）：

wget https://github.com/RchGrav/claudebox/releases/latest/download/claudebox.run
chmod +x claudebox.run
./claudebox.run

方式二，归档安装：

ARCHIVE=claudebox-2.0.1.tar.gz
wget "https://github.com/RchGrav/claudebox/releases/latest/download/$ARCHIVE"
mkdir -p ~/my-tools/claudebox
tar -xzf "$ARCHIVE" -C ~/my-tools/claudebox --strip-components=1
cd ~/my-tools/claudebox
./main.sh

常见报错：若 claudebox 命令找不到，需把安装目录加入 PATH：export PATH="$HOME/.local/bin:$PATH"（写入 ~/.bashrc 或 ~/.zshrc 后重载）。

五、使用示例

cd ~/projects/my-project
claudebox create        # 创建第一个 slot
claudebox slots         # 查看槽位号、认证与运行状态
claudebox add python    # 给当前 slot 追加 python 开发档案
claudebox slot 1        # 启动 slot 1，首次需在 Claude 内认证

真实流程：create 后 slots 会列出 1 号槽位、状态为未认证；执行 slot 1 进入容器，在 Claude 里完成登录，之后该 slot 即可独立运行 Claude Code，环境与其他 slot 完全隔离。

六、常见问题

Q：需要提前装 Docker 吗？
A：需要，ClaudeBox 基于 Docker 运行，请先安装 Docker Desktop 或 docker-ce。

Q：slot 里的数据会丢吗？
A：槽位数据持久化在 Docker 卷中，删除 slot 前注意备份。

Q：能在无 GUI 的服务器上用吗？
A：可以，slot 通过终端进入，天然适合无头服务器。

七、总结

ClaudeBox 把“Claude Code + 开发环境”打包成可复现的容器，解决了环境漂移与隔离两大痛点。对需要统一、干净 AI 编程环境的团队，它比各自配环境省心得多，MIT 协议开源。