Repolode
Enviar
nikvdp

nikvdp/cco

Um wrapper de sandbox que executa Claude Code (e outros agentes de programação com IA) com aprovação automática em um sandbox nativo do sistema operacional ou no Docker, protegendo sua máquina.

Ver no GitHub
Estrelas
429
Forks
32
Issues abertas
2
Último commit
há 26 dias

O que é?

cco é um wrapper de linha de comando simples que executa Claude Code em um sandbox para que ele possa trabalhar sem solicitações repetidas de permissão, limitando ao mesmo tempo o que pode acessar na sua máquina. Ele escolhe automaticamente o melhor backend disponível: sandbox-exec no macOS ou bubblewrap no Linux, quando disponíveis, e Docker como alternativa. No modo nativo, o sistema de arquivos do host fica exposto como somente leitura por padrão; no modo Docker, apenas os caminhos montados explicitamente ficam visíveis.

O principal problema que ele aborda é o risco de prompt injection ao executar Claude Code com as verificações de permissão desativadas. Os arquivos do projeto, os caminhos de estado e os metadados de git worktree continuam graváveis, e as credenciais são montadas em tempo de execução, em vez de serem incorporadas às imagens. Opções como --safe, --deny-path, --allow-readonly e --add-dir permitem restringir ou ampliar o acesso. O acesso à rede é intencionalmente irrestrito; portanto, o foco do projeto é o isolamento do sistema de arquivos e das credenciais, não o controle de rede.

Além do Claude Code, cco pode encapsular a CLI Codex da OpenAI, OpenCode, Pi e droid da factory.ai; sua opção --command executa CLIs arbitrárias no mesmo sandbox.

Recursos principais

  • 01Seleciona automaticamente sandbox-exec, bubblewrap ou Docker, conforme a disponibilidade.
  • 02O modo nativo expõe o sistema de arquivos do host como somente leitura, mantendo os diretórios do projeto graváveis.
  • 03O modo Docker monta apenas os caminhos especificados explicitamente.
  • 04Oferece suporte a git worktrees e ao acesso às credenciais do macOS Keychain.
  • 05Disponibiliza flags para ocultar, compartilhar ou bloquear caminhos específicos.
  • 06Encapsula Claude Code, Codex, OpenCode e outras CLIs de agentes com um único comando.

Casos de uso

  • Executar Claude Code com aprovação automática em um laptop sem expor chaves SSH ou arquivos não relacionados do diretório home.
  • Permitir que um agente de IA execute testes ou builds em um ambiente isolado.
  • Colocar qualquer ferramenta de CLI em um sandbox com a opção --command.
  • Usar um container Docker persistente para manter as ferramentas instaladas entre sessões.

Início rápido

  1. 1

    Execute o script oficial de instalação indicado no README

  2. 2

    Execute cco no diretório do seu projeto em vez de claude

    cco "write a hello world script"

Antes de usar

  • O sandbox nativo expõe todo o sistema de arquivos do host como somente leitura por padrão. Use --safe para obter um isolamento mais rigoroso; esse recurso é experimental.
  • Algumas opções, como --docker-socket, enfraquecem ou anulam o isolamento e são marcadas como experimentais.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceApps open source para MacFerramentas de varredura, auditoria e inteligência de ameaças

Tópicos

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

Perguntas frequentes

O que é cco?
Um wrapper de sandbox que executa Claude Code (e outros agentes de programação com IA) com aprovação automática em um sandbox nativo do sistema operacional ou no Docker, protegendo sua máquina. cco é um wrapper de linha de comando simples que executa Claude Code em um sandbox para que ele possa trabalhar sem solicitações repetidas de permissão, limitando ao mesmo tempo o que pode acessar na sua máquina. Ele escolhe automaticamente o melhor backend disponível: sandbox-exec no macOS ou bubblewrap no Linux, quando disponíveis, e Docker como alternativa. No modo nativo, o sistema de arquivos do host fica exposto como somente leitura por padrão; no modo Docker, apenas os caminhos montados explicitamente ficam visíveis.
cco é gratuito? Qual é a licença?
cco é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
cco ainda é mantido?
Manutenção ativa. O último commit de cco foi em 29 de set. de 2026.
Para que posso usar cco?
Executar Claude Code com aprovação automática em um laptop sem expor chaves SSH ou arquivos não relacionados do diretório home. Permitir que um agente de IA execute testes ou builds em um ambiente isolado. Colocar qualquer ferramenta de CLI em um sandbox com a opção --command. Usar um container Docker persistente para manter as ferramentas instaladas entre sessões.
Como instalar cco?
Execute o script oficial de instalação indicado no README Execute cco no diretório do seu projeto em vez de claude: cco "write a hello world script"
Onde consigo cco?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nikvdp/cco

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados