nikvdp/cco

A thin protective layer for Claude Code

cco 是 Claude Code 和 OpenAI 的 Codex 等 AI 编码代理的安全部署包装器。它将这些代理运行在隔离环境中,以防止恶意提示注入或意外操作对您的系统造成损害,同时保持无缝的终端体验。

为何重要: AI 编码代理通常需要广泛的文件和 shell 访问权限才能发挥作用。但这同时也意味着,如果它们受到恶意提示(例如来自恶意网页的提示)的欺骗,可能会删除文件、泄露数据或执行任意命令。cco 在代理与您的真实机器之间设置了一道屏障,以防止此类风险。

工作原理:

  • 自动选择最佳沙箱方法:当可用时使用原生操作系统沙箱(macOS 上的 sandbox-exec,Linux 上的 bubblewrap),否则使用 Docker。
  • 代理在沙箱内运行,仅挂载项目目录和显式共享的路径。其余文件系统要么只读,要么隐藏。
  • 凭据(如 macOS Keychain 中的 Claude 认证)在运行时安全注入,从不嵌入镜像中。
  • 保留终端功能(调整大小、信号等),使代理的 UI 感觉像原生应用一样。

主要特性:

  • 零配置: 安装一次后,只需输入 cco 而非 claude 即可。
  • 多代理支持: 支持 Claude Code、OpenAI 的 Codex、OpenCode 等多种代理。
  • 灵活的沙箱: 可选择原生或 Docker,或让其自动检测。
  • 持久会话: 可选择在多次运行间复用容器文件系统(--persist)。
  • 自定义挂载: 可读写或只读共享额外目录,拒绝特定路径,或创建例外。
  • 通用包装器: 使用 cco --command 可对任何 CLI 进行沙箱化,不仅限于 AI 代理。

快速开始:

curl -fsSL https://raw.githubusercontent.com/nikvdp/cco/master/install.sh | bash
cco "write a hello world script"

它被设计为完全透明——您将享受到完全自主 AI 编码的速度,同时拥有一个保护系统完整的安全网。

相关

  • 项目
  • 项目
  • 项目
  • Dispatch