Repolode
Enviar
nikvdp

nikvdp/cco

Un wrapper de sandbox que ejecuta Claude Code y otros agentes de programación con IA con aprobación automática dentro del aislamiento nativo del sistema operativo o de Docker, para proteger mejor tu equipo.

Ver en GitHub
Estrellas
429
Forks
32
Issues abiertos
2
Último commit
hace 26 días

¿Qué es?

cco es un wrapper ligero de línea de comandos que ejecuta Claude Code en un sandbox para que pueda trabajar sin pedir permiso a cada paso, limitando al mismo tiempo lo que puede tocar en tu equipo. Selecciona automáticamente el backend disponible más adecuado: sandbox-exec en macOS o bubblewrap en Linux, si están instalados, y Docker como alternativa. En el modo nativo, el sistema de archivos del host queda expuesto como solo lectura de forma predeterminada; en el modo Docker, solo son visibles las rutas montadas explícitamente.

El principal problema que aborda es el riesgo de inyección de prompts al ejecutar Claude Code con las comprobaciones de permisos desactivadas. Los archivos del proyecto, las rutas de estado y los metadatos de los worktrees de git siguen siendo modificables, y las credenciales se montan en tiempo de ejecución en lugar de incluirse en las imágenes. Opciones como --safe, --deny-path, --allow-readonly y --add-dir permiten restringir o ampliar el acceso. El acceso a la red no tiene restricciones intencionadamente, por lo que el proyecto se centra en aislar el sistema de archivos y las credenciales, no en controlar la red.

Además de Claude Code, cco puede ejecutar OpenAI's Codex CLI, OpenCode, Pi y droid de factory.ai; también permite ejecutar cualquier CLI en el mismo sandbox mediante la opción --command.

Funciones clave

  • 01Selecciona automáticamente sandbox-exec, bubblewrap o Docker según lo que esté disponible.
  • 02El modo nativo expone el sistema de archivos del host como solo lectura, pero permite modificar los directorios del proyecto.
  • 03El modo Docker monta únicamente las rutas especificadas de forma explícita.
  • 04Es compatible con worktrees de git y con el acceso a las credenciales del Llavero de macOS.
  • 05Ofrece opciones para ocultar, compartir o denegar el acceso a rutas específicas.
  • 06Ejecuta Claude Code, Codex, OpenCode y otros CLIs de agentes con un solo comando.

Casos de uso

  • Ejecutar Claude Code con aprobación automática en una laptop sin exponer claves SSH ni archivos irrelevantes del directorio personal.
  • Permitir que un agente de IA ejecute pruebas o compilaciones en un entorno aislado.
  • Ejecutar cualquier herramienta CLI en un sandbox mediante la opción --command.
  • Usar un contenedor Docker persistente para conservar las herramientas instaladas entre sesiones.

Inicio rápido

  1. 1

    Ejecuta el script de instalación oficial que aparece en el README

  2. 2

    Ejecuta cco en el directorio de tu proyecto en lugar de claude

    cco "write a hello world script"

Antes de usarlo

  • El sandbox nativo expone todo el sistema de archivos del host como de solo lectura de forma predeterminada. Usa --safe para obtener un aislamiento más estricto; esta opción es experimental.
  • Algunas opciones, como --docker-socket, debilitan o anulan el aislamiento y están marcadas como experimentales.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceApps open source para MacHerramientas de escaneo, auditoría e inteligencia de amenazas

Temas

#claude-code#sandbox#ai-agent#docker#bubblewrap#security#macos#linux

Preguntas frecuentes

¿Qué es cco?
Un wrapper de sandbox que ejecuta Claude Code y otros agentes de programación con IA con aprobación automática dentro del aislamiento nativo del sistema operativo o de Docker, para proteger mejor tu equipo. cco es un wrapper ligero de línea de comandos que ejecuta Claude Code en un sandbox para que pueda trabajar sin pedir permiso a cada paso, limitando al mismo tiempo lo que puede tocar en tu equipo. Selecciona automáticamente el backend disponible más adecuado: sandbox-exec en macOS o bubblewrap en Linux, si están instalados, y Docker como alternativa. En el modo nativo, el sistema de archivos del host queda expuesto como solo lectura de forma predeterminada; en el modo Docker, solo son visibles las rutas montadas explícitamente.
¿cco es gratuito? ¿Qué licencia tiene?
cco es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿cco sigue mantenido?
Mantenimiento activo. El último commit de cco fue el 29 sept 2026.
¿Para qué puedo usar cco?
Ejecutar Claude Code con aprobación automática en una laptop sin exponer claves SSH ni archivos irrelevantes del directorio personal. Permitir que un agente de IA ejecute pruebas o compilaciones en un entorno aislado. Ejecutar cualquier herramienta CLI en un sandbox mediante la opción --command. Usar un contenedor Docker persistente para conservar las herramientas instaladas entre sesiones.
¿Cómo se instala cco?
Ejecuta el script de instalación oficial que aparece en el README Ejecuta cco en el directorio de tu proyecto en lugar de claude: cco "write a hello world script"
¿Dónde consigo cco?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/nikvdp/cco

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados