AI 에이전트가 파일을 읽고 API를 호출할 때, 데이터와 네트워크를 안전하게 지키는 방법
AI 에이전트가 파일을 열거나 패키지를 설치하고 API를 호출하는 순간, 당신의 데이터와 비밀 키가 위험에 처할 수 있습니다. OpenShell은 에이전트가 필요한 기능은 쓰되, 접근할 수 없는 영역은 철저히 막아주는 실행 환경을 제공합니다. 에이전트가 무엇을 할 수 있는지 정책으로 선언하면, 시스템이 이를 강제합니다.
CNCF 이사와 0.1.x 버전의 변화
OpenShell은 이제 CNCF(Cloud Native Computing Foundation)의 일부가 되었으며, 개발은 ai-openshell로, 거버넌스는 CNCF로 이동하는 과정에 있습니다. 이사가 완료될 때까지 코드는 NVIDIA/OpenShell 저장소에서 계속 관리됩니다. 0.1.x 버전에서는 안정적인 릴리스 주기, 새로운 격리 원시, 확장된 확장 표면, 그리고 새로운 API가 도입되었습니다. 업그레이드 가이드를 확인하여 변경 사항을 파악하는 것이 좋습니다.
커널 수준 강제와 형식 검증
OpenShell은 에이전트의 행동을 두 가지 방식으로 통제합니다. 먼저, 커널을 계측하여 모든 파일 접근, 시스템 호출, 네트워크 연결을 런타임에서 정책대로 강제합니다. 각 에이전트는 격리된 샌드박스에서 실행되며, 실제 자격 증명은 보이지 않고 승인된 엔드포인트로만 요청 시 추가됩니다. 둘째, 정책 변경을 적용하기 전에 형식 검증을 수행합니다. 새로운 호스트 접근이나 API 호출과 같은 위험한 접근을 사전에 감지하여 인간 검토를 기다리게 만듭니다.
설치와 첫 실행
Linux, Apple Silicon 기반 macOS, 또는 WSL 2가 포함된 Windows(실험적) 환경이 필요합니다. Docker, Podman, 또는 호스트 가상화도 필수입니다. 설치 스크립트를 실행하면 CLI와 로컬 게이트웨이가 설정됩니다. 기본 샌드박스 이미지는 에이전트가 없는 최소한의 Ubuntu입니다. 실제 에이전트를 실행하려면 OpenCode를 무료 OpenRouter 모델과 함께 사용하는 가이드를 따라야 하며, 에이전트가 새로운 접근을 필요로 할 때 승인하는 과정을 보여줍니다.
에이전트 스킬과 SDK
코딩 에이전트가 OpenShell CLI를 구동하고 샌드박스 정책을 작성하며 게이트웨이를 디버깅하도록 돕는 공개 스킬을 설치할 수 있습니다. npx skills add NVIDIA/OpenShell 명령으로 설치하며, 소스 체크아웃 없이도 작동합니다. Python, TypeScript, Go, Rust SDK를 통해 애플리케이션을 OpenShell 게이트웨이에 연결할 수 있습니다. SDK는 CLI를 설치하지 않으며, 가능하면 SDK와 게이트웨이에 동일한 OpenShell 릴리스를 사용하는 것이 좋습니다.
사용 전 확인 사항
OpenShell은 Apache License 2.0으로 라이선스가 부여되며, 소프트웨어는 'AS IS' 상태로 제공됩니다. 익명 텔레메트리를 수집하지만, 샌드박스 이름, 파일 경로, 프롬프트, 자격 증명, 사용자 콘텐츠는 수집하지 않습니다. 텔레메트리를 비활성화하거나 컴파일 시 제거할 수 있습니다.