AI 코딩 도구가 실수로 실행할 수 있는 위험한 명령을 실행 전에 막아주는 안전장치
AI 코딩 도구가 git reset --hard나 rm -rf 같은 명령을 실행하려 할 때, 그 명령이 실제로 터미널에 전달되기 전에 가로채서 실행을 중단합니다. 이 도구는 AI 에이전트가 실수로 중요한 데이터를 삭제하거나 시스템을 망가뜨리는 것을 방지하는 중간 단계의 안전장치 역할을 합니다. 설치 후 에이전트가 명령을 실행할 때마다 자동으로 검사하여 위험한 패턴을 발견하면 실행을 막고, 왜 막았는지와 더 안전한 대안을 알려줍니다.
명령 실행 전 실시간 차단
이 도구는 AI 에이전트가 명령을 실행하기 직전에 개입하여 명령 내용을 분석합니다. 분석 속도가 매우 빨라 사용자가 체감할 지연이 거의 없습니다. 단순히 명령 문자열을 매칭하는 것을 넘어, 명령이 실제로 실행되는 문맥인지 데이터로 언급되는 것인지 구분합니다. 예를 들어 grep "rm -rf"처럼 텍스트로만 언급된 경우와 실제 rm -rf /를 실행하려는 경우를 정확히 구분하여 오작동을 줄입니다. 차단이 발생하면 터미널에 명확한 이유와 대안을 표시하여 사용자가 상황을 즉시 파악할 수 있게 합니다.
50개 이상의 보안 팩으로 확장 가능한 보호 범위
기본적으로 파일 시스템과 Git 관련 위험 명령을 차단하지만, 설정 파일을 통해 다양한 도구의 위험 명령을 추가로 차단할 수 있습니다. 데이터베이스, 컨테이너, 클라우드, 인프라 도구 등 50개 이상의 보안 팩이 제공되어 사용 환경에 맞게 선택적으로 활성화할 수 있습니다. 예를 들어 PostgreSQL의 DROP TABLE이나 Docker의 system prune, AWS의 인스턴스 종료 명령 등을 차단할 수 있습니다. 각 팩은 독립적으로 관리되며, 카테고리 단위로 전체를 활성화하거나 개별 팩만 선택하는 것도 가능합니다. 이는 특정 도구를 주로 사용하는 개발자가 해당 도구의 위험한 명령만 집중적으로 관리할 수 있게 합니다.
다양한 AI 코딩 에이전트와의 통합
Claude Code, Codex CLI, Gemini CLI, GitHub Copilot, Cursor 등 주요 AI 코딩 에이전트와 호환됩니다. 설치 스크립트가 사용자의 플랫폼과 에이전트를 자동으로 감지하여 필요한 설정을 적용합니다. 각 에이전트가 명령을 실행하는 방식이 다르기 때문에, 해당 에이전트의 프로토콜에 맞춰 차단 신호를 전달합니다. 예를 들어 Codex CLI는 표준 출력에 JSON 형식의 거부 메시지를 전달하고, 다른 에이전트는 에러 스트림에 인간이 읽을 수 있는 메시지를 출력합니다. 이러한 통합 덕분에 에이전트마다 별도의 설정을 하지 않아도 동일한 수준의 보호를 받을 수 있습니다.
설치 및 초기 설정
Linux, macOS, Windows(WSL)에서 지원되며, 단일 커맨드로 설치할 수 있습니다. 설치 스크립트는 플랫폼을 감지하고 올바른 바이너리를 다운로드한 후, 감지된 에이전트들의 훅 설정을 자동으로 구성합니다. Windows 네이티브 환경에서는 PowerShell 설치 스크립트를 사용하며, SHA256 체크섬과 서명 검증을 통해 바이너리의 무결성을 확인합니다. 기본 설정 파일이 없어도 가장 위험한 파일 시스템과 Git 명령은 자동으로 차단됩니다. 추가적인 보호가 필요하면 ~/.config/dcg/config.toml 파일을 생성하여 활성화할 보안 팩을 지정하면 됩니다.
사용 전 확인 사항
이 도구는 AI 에이전트가 실행하는 모든 명령을 검사하므로, 의도적으로 위험한 명령을 실행해야 하는 경우 우회 방법이 필요합니다. 환경 변수 DCG_BYPASS=1을 설정하거나, 일시적 허용 코드를 사용하여 특정 명령만 우회할 수 있습니다. 반복적으로 필요한 명령은 허용 목록에 추가하는 것이 좋습니다. 또한, core.filesystem과 core.git 팩은 항상 활성화되며 비활성화할 수 없으므로, 이 범위의 명령은 반드시 차단됩니다. 특정 규칙의 심각도를 낮추려면 규칙 ID를 명시적으로 지정해야 하며, 일반적인 설정 변경만으로는 critical 등급의 규칙을 완화할 수 없습니다. 자신의 워크플로우에서 어떤 명령이 차단되는지 dcg explain 명령으로 미리 확인해 보는 것이 좋습니다.
