nikvdp/cco

cco 는 Claude Code 및 OpenAI의 Codex와 같은 AI 코드 에이전트를 위한 보안 래퍼입니다. 이 도구는 에이전트를 격리된 환경에서 실행하여 악성 프롬프트에 속아서 파일을 삭제하거나 데이터를 유출하거나 임의의 명령을 실행하는 등의 위험으로부터 시스템을 보호하면서도, 원활한 터미널 경험을 유지합니다.

왜 중요한가: AI 코드 에이전트는 유용하기 위해 파일과 쉘에 광범위한 접근 권한이 필요합니다. 하지만 이는 악성 프롬프트(예: 읽은 악성 웹페이지에서 오는 것)에 속아 에이전트가 파일을 삭제하거나 데이터를 유출하거나 임의의 명령을 실행할 수 있다는 위험을 동반합니다. cco는 에이전트와 실제 머신 사이에 장벽을 두어 이를 방지합니다.

작동 방식:

• 운영체제의 네이티브 사전 환경(sandbox-exec on macOS, bubblewrap on Linux)이 사용 가능한 경우 자동으로 선택하고, 그렇지 않으면 Docker를 사용합니다.
• 에이전트는 프로젝트 디렉터리와 명시적으로 공유된 경로만 마운트된 사전 환경에서 실행됩니다. 나머지 파일 시스템은 읽기 전용이거나 숨겨집니다.
• 인증 정보(예: macOS Keychain에서 가져온 Claude 인증)는 런타임에 안전하게 주입되며, 이미지에 포함되지 않습니다.
• 에이전트의 UI가 네이티브처럼 느껴지도록 터미널 기능(크기 조절, 시그널 등)을 유지합니다.

주요 기능:

• 제로 설정: 한 번 설치하면 claude 대신 cco만 입력하면 됩니다.
• 다중 에이전트 지원: Claude Code, OpenAI의 Codex, OpenCode 등 다양한 에이전트를 지원합니다.
• 유연한 사전 환경: 네이티브 또는 Docker를 선택하거나, 자동 감지 기능을 사용할 수 있습니다.
• 지속 세션: 옵션으로 실행 간에 컨테이너 파일 시스템을 재사용할 수 있습니다(--persist).
• 사용자 정의 마운트: 추가 디렉터리를 읽기 전용 또는 읽기/쓰기로 공유하거나, 특정 경로를 차단하거나 예외를 설정할 수 있습니다.
• 일반 래퍼: cco --command를 사용해 AI 에이전트 외의 CLI도 사전 환경에 래핑할 수 있습니다.

빠른 시작:

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

사용자는 완전히 무심한 상태에서, 자율적인 AI 코드 작성의 속도를 누리면서도 시스템이 보호된 상태를 유지할 수 있습니다.