claudebox

Q: 安装后提示 claudebox: command not found 怎么办？

把 ~/.local/bin 加入 PATH（例如 export PATH=＂$HOME/.local/bin:$PATH＂），写入 shell 配置文件后重开终端，再重新执行 claudebox。

一条命令把 Claude Code 装进 Docker，环境干净可复现

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 130 🐛 待处理 20 👀 关注 11

GitHub ↗

GitHub 星标 ★ 1169

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，需自行部署 Docker 环境

项目预览

项目数据

分类编程开发

开发团队RchGrav

GitHubhttps://github.com/RchGrav/claudebox

定价模式🏷️完全免费

价格说明开源免费，需自行部署 Docker 环境

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Shell

GitHub 星标★ 1169

上线时间2025-06-06 00:00:00

代码更新2026-09-17

仓库体积3.8 MB

本站数据更新2026-11-06

维护状态维护中

收录时间2026-09-23

浏览次数1

项目介绍

claudebox 是一个把 Claude Code（Anthropic 的 AI 编程助手）完整装进 Docker 容器的开发环境方案。它解决的核心问题是：Claude Code 直接跑在宿主机上时，容易污染本地环境、依赖版本冲突、不同机器上行为不一致、权限与凭据管理混乱。claudebox 通过预置的开发 profile，把 Claude Code、常用语言工具链和运行时依赖打包成可复现镜像，让你在任何支持 Docker 的机器上一条命令拉起一致的 AI 编码环境。核心能力包括：容器化隔离运行 Claude Code、按语言/框架选择预配置 profile、挂载项目目录实现宿主机与容器内文件同步、统一管理 API 密钥等环境变量，并支持在 CI 或远程服务器上复用同一套环境。对于需要团队统一 AI 编码环境、或不想让 AI 助手直接操作本机文件系统的开发者，它提供了一层干净、可重建的沙箱。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-23 · 当前星标 ★ 1169

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

已安装并可使用 Docker（ClaudeBox 会自动处理 Docker 配置，必要时把你加入 docker 组）
类 Unix 环境（安装脚本与 PATH 配置均为 Shell 脚本）
安装后需保证 ~/.local/bin 在你的 PATH 中
当前项目目录会被读写挂载到容器内 /workspace（含 .git）
磁盘上可写 ~/.claudebox/ 用于存放源码、项目状态与缓存

安装与启动步骤

1安装 claudebox

README 推荐自解压安装器（适合自动化与快速安装）；也可下载归档包解压到自定义目录，然后运行 main.sh 创建符号链接。
```
cd ~/my-tools/claudebox
./main.sh
```
2配置 PATH

安装后如果找不到 claudebox 命令，需要把 ~/.local/bin 加入 PATH，建议写进 shell 配置文件后重新加载。
```
export PATH="$HOME/.local/bin:$PATH"
```
3安装语言 Profile

按项目需要选择预配置 profile，可一次指定多个，自动解析依赖（如 C 会带上 build-tools）。
```
claudebox profile python ml
```
4安装额外软件包

在项目级环境中补充常用工具，例如 htop、vim、tmux，安装作用于当前项目而非宿主机。
```
claudebox install htop vim tmux
```
5查看可用 Profile

profiles 命令会快速列出所有可用 profile 及说明，方便确认上一步是否安装成功。
```
claudebox profiles
```
6配置 SSH 目录

建议创建专用 SSH 目录，ClaudeBox 会以读写方式挂载它；否则会只读挂载宿主机 ~/.ssh。
```
mkdir -p ~/.claudebox/ssh
chmod 700 ~/.claudebox/ssh
```

关键配置

配置项	必填	说明	示例
`PATH`	是	必须包含 ~/.local/bin 才能直接调用 claudebox	`$HOME/.local/bin:$PATH`
`~/.claudebox/ssh/`	否	可选专用 SSH 目录，以读写方式挂载，用于持久化 known_hosts	`~/.claudebox/ssh`
`~/.claude.json`	否	用户 MCP 配置读取来源，容器不会挂载整个 ~/.claude 目录	`~/.claude.json`
`profiles.ini`	否	项目级共享状态文件，记录该项目已安装的 profile	`~/.claudebox/projects/<project-id>/profiles.ini`