nikvdp/cco

어떤 프로젝트인가요?

핵심 기능

• 01사용 가능한 환경에 따라 sandbox-exec, bubblewrap 또는 Docker를 자동으로 선택합니다.
• 02네이티브 모드에서는 호스트 파일 시스템을 읽기 전용으로 노출하고, 프로젝트 디렉터리는 쓰기 가능하게 둡니다.
• 03Docker 모드에서는 명시적으로 지정한 경로만 마운트합니다.
• 04git worktree와 macOS Keychain의 자격 증명 접근을 지원합니다.
• 05특정 경로를 숨기거나 공유하거나 접근을 거부하는 플래그를 제공합니다.
• 06단일 명령으로 Claude Code, Codex, OpenCode 및 기타 에이전트 CLI를 실행합니다.

활용 사례

• SSH 키나 관련 없는 홈 디렉터리 파일을 노출하지 않고 노트북에서 Claude Code를 자동 승인으로 실행하기.
• AI 에이전트가 격리된 환경에서 테스트나 빌드를 실행하도록 하기.
• --command 옵션으로 임의의 CLI 도구를 샌드박스에서 실행하기.
• 세션이 바뀌어도 설치한 도구를 유지하도록 영구 Docker 컨테이너 사용하기.

빠른 시작

1. 1

   README의 공식 설치 스크립트를 실행합니다

2. 2

   claude 대신 프로젝트 디렉터리에서 cco를 실행합니다

   cco "write a hello world script"

사용 전 알아둘 점

• !네이티브 샌드박싱은 기본적으로 호스트 파일 시스템 전체를 읽기 전용으로 노출합니다. 더 강력한 격리를 원하면 --safe를 사용하세요. 이 기능은 실험적입니다.
• !--docker-socket과 같은 일부 옵션은 격리를 약화하거나 무력화하므로 실험적 기능으로 표시되어 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

cco은(는) 무엇인가요?

Claude Code와 다른 AI 코딩 에이전트를 기본 OS 샌드박스나 Docker 안에서 자동 승인으로 실행해, 컴퓨터를 더 안전하게 지켜 주는 샌드박스 래퍼입니다. cco는 Claude Code를 샌드박스 안에서 실행하는 가벼운 CLI 래퍼입니다. 반복해서 권한을 묻지 않고 작업할 수 있게 하면서도 컴퓨터에서 접근 가능한 범위를 제한합니다. 사용 가능한 백엔드 중 가장 적합한 것을 자동으로 선택합니다. macOS에서는 sandbox-exec를, Linux에서는 설치되어 있다면 bubblewrap을 사용하고, 그 외에는 Docker를 대안으로 사용합니다. 기본적으로 네이티브 모드에서는 호스트 파일 시스템을 읽기 전용으로 노출하고, Docker 모드에서는 명시적으로 마운트한 경로만 접근할 수 있습니다.

cco은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

cco은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

cco은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. cco의 마지막 커밋은 2026년 9월 29일입니다.

cco은(는) 어디에 사용할 수 있나요?

SSH 키나 관련 없는 홈 디렉터리 파일을 노출하지 않고 노트북에서 Claude Code를 자동 승인으로 실행하기. AI 에이전트가 격리된 환경에서 테스트나 빌드를 실행하도록 하기. --command 옵션으로 임의의 CLI 도구를 샌드박스에서 실행하기. 세션이 바뀌어도 설치한 도구를 유지하도록 영구 Docker 컨테이너 사용하기.

cco는 어떻게 설치하나요?

README의 공식 설치 스크립트를 실행합니다 claude 대신 프로젝트 디렉터리에서 cco를 실행합니다: cco "write a hello world script"

cco은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nikvdp/cco