open-harness은(는) 무엇을 하나요?
AI 코딩 에이전트를 위한 완전 권한, 영구 메모리, 백그라운드 작업 지원의 격리된 샌드박스 컨테이너를 Docker에서 실행합니다.
개요
trimanabas391/open-harness는 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)가 Docker 컨테이너 안에서 코드를 실행하고, 시스템 패키지를 설치하며, 장기 실행 프로세스를 안전하게 실행할 수 있게 해주는 격리된 환경을 제공합니다.
이 샌드박스는 호스트 시스템과 완전히 격리되어 있으므로, 에이전트가 시스템을 변경하거나 바이러스를 설치할 위험이 없습니다. 컨테이너는 실행이 끝난 후 자동으로 제거됩니다.
주요 기능
- 완전 권한: 컨테이너 내에서 루트 권한으로 실행되므로 패키지 설치, 시스템 설정 변경 등 자유롭게 수행 가능
- 영구 메모리: 컨테이너가 종료되어도 작업 내역과 설치된 소프트웨어가 유지됨
- 백그라운드 작업: 장기 실행 프로세스(예: 웹 서버, 데이터베이스)를 백그라운드에서 실행 가능
- 안전한 격리: 호스트 시스템과 완전히 분리되어 있어 안전하게 실험 가능
- 결과물 전달: 컨테이너 내에서 생성된 파일과 출력을 호스트로 전달 가능
사용 방법
기본 사용법
에이전트가 샌드박스 컨테이너를 시작하려면 다음 명령을 사용합니다:
# 기본 샌드박스 실행
docker run -it --rm --name agent-sandbox trimanabas391/open-harness
영구 메모리 사용
볼륨을 마운트하여 데이터를 지속할 수 있습니다:
docker run -it --rm \
-v agent-data:/home/agent/data \
--name agent-sandbox \
trimanabas391/open-harness
백그라운드 작업 실행
# 샌드박스 내에서 장기 실행 프로세스 시작
docker exec -d agent-sandbox bash -c "python3 -m http.server 8000 &"
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 코딩 에이전트
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
WORK_DIR | 작업 디렉터리 | /home/agent |
MEMORY_ENABLED | 영구 메모리 활성화 | true |
CLEANUP_ON_EXIT | 종료 시 컨테이너 정리 | true |
주의사항
- 컨테이너 내에서 수행된 모든 작업은 격리된 환경에서만 영향을 미칩니다.
- 호스트 시스템 파일에 접근하려면 명시적으로 볼륨 마운트가 필요합니다.
- 백그라운드 작업은 컨테이너가 실행 중일 때만 유지됩니다.