Capri 튜토리얼: Windows AI 에이전트로 파일, 프로젝트, 코드 제어하기

Capri란?

Capri는 Windows용 오픈 소스 사이버펑크 테마 AI 에이전트입니다. AI 어시스턴트를 통해 파일, 프로젝트 폴더, 코드, 셸 도구, 애플리케이션 및 웹을 작업할 수 있는 네이티브 데스크톱 인터페이스를 제공합니다. 터미널 명령을 직접 작성하는 대신 목표를 자연어로 설명하면 Capri가 작업을 조율합니다.

Capri는 인터페이스와 도구 계층을 담당하고, 외부 어시스턴트가 AI 추론을 제공합니다. 기본적으로 Claude Code, Codex, Antigravity를 지원합니다. 사용자 지정 어댑터를 통해 다른 어시스턴트도 연결할 수 있습니다.

Capri는 사이버펑크 장르와 Cyberpunk: Edgerunners에서 영감을 받은 독립적인 비공식 팬 프로젝트입니다. CD PROJEKT RED, Netflix, Studio Trigger, Anthropic, OpenAI 또는 Google과 제휴하거나 해당 기업의 승인을 받은 제품이 아닙니다.

주요 기능

• 다중 AI 엔진: Claude Code, Codex, Antigravity 또는 사용자 지정 어댑터를 통한 다른 어시스턴트를 연결할 수 있습니다.
• 네이티브 Windows 인터페이스: 터미널에서 직접 작업하는 대신 설치된 데스크톱 애플리케이션을 사용할 수 있습니다.
• 파일 및 프로젝트 도구: 파일이나 전체 프로젝트 폴더를 찾고, 읽고, 정리하고, 편집할 수 있습니다.
• 에이전트 워크플로: Capri는 작업을 계획하고, 도구를 요청하고, 결과를 확인한 뒤 수행한 작업을 보고할 수 있습니다.
• 코드 지원: 선택한 엔진에 코드 작성, 리팩터링, 디버깅 및 실행을 요청할 수 있습니다.
• 승인 제어: 민감한 작업을 검토하고 Capri가 시스템을 변경하기 전에 승인하거나 거부할 수 있습니다.
• 범위 설정: 선택한 폴더로 액세스를 제한하고, 확인 요청, 자동 또는 읽기 전용 권한 동작을 선택할 수 있습니다.

요구 사항

Capri에는 현재 Windows 10 이상이 필요합니다. Windows용 .exe 설치 프로그램으로 배포됩니다. macOS 및 Linux 버전은 프로젝트 로드맵에 포함되어 있지만 현재는 제공되지 않습니다.

또한 지원되는 AI 어시스턴트 계정이나 API 키가 필요합니다. Capri 자체는 MIT 라이선스에 따라 오픈 소스로 제공되지만, 연결된 AI 제공업체는 자체 요금 정책에 따라 사용 요금을 부과할 수 있습니다.

Windows에 Capri 설치하기

1. 설치 프로그램 다운로드

최신 Capri 릴리스를 열고 Capri-Setup.exe를 다운로드합니다. 출처를 알 수 없는 타사 다운로드 사이트가 아니라 공식 저장소의 릴리스 페이지를 사용하세요.

2. 설치 마법사 실행

1. Capri-Setup.exe를 엽니다.
2. 설치 마법사의 안내를 따릅니다.
3. 설치가 끝나면 Windows 시작 메뉴에서 Capri를 엽니다.

Capri는 아직 다운로드 기록이 충분히 축적되지 않은 새로운 애플리케이션이므로 Windows SmartScreen에서 경고를 표시할 수 있습니다. 공식 릴리스 페이지에서 설치 프로그램을 받았다면 추가 정보를 선택한 다음 실행을 선택하여 계속 진행하세요.

3. AI 엔진 연결

처음 실행하면 Capri에서 어시스턴트를 선택하라는 메시지가 표시됩니다. Claude Code, Codex, Antigravity 또는 지원되는 다른 옵션을 선택한 다음 로그인하거나 요청된 API 키를 입력합니다.

요청은 연결한 어시스턴트가 처리합니다. 따라서 해당 처리에는 제공업체의 약관, 개인정보 보호정책, 요금 정책 및 계정 규칙이 적용됩니다.

Capri의 작업 처리 방식

1. 목표 설명: 데스크톱 애플리케이션에 자연어로 요청을 입력합니다.
2. Capri가 엔진 선택: 요청이 설정된 AI 어시스턴트로 전달됩니다.
3. 엔진이 계획 수립: 어시스턴트가 필요한 단계와 도구를 결정합니다.
4. Capri가 민감한 작업 표시: 권한 설정에 따라 요청된 파일 또는 시스템 작업을 검토할 수 있습니다.
5. 승인 또는 거부: 승인된 작업은 Capri의 도구 계층을 통해 수행됩니다.
6. Capri가 결과 보고: 에이전트가 결과를 확인하고 수행한 작업을 요약합니다.

기본 사용 예시

폴더 정리

폴더를 정리하려면 대상 위치를 지정하고 원하는 정리 방식을 설명하세요.

내 다운로드 폴더를 정리하고 파일을 유형별로 그룹화해 줘. 이동하기 전에 계획을 보여 줘.

Capri는 폴더를 검색하고 계획을 제안한 다음 파일을 이동하기 전에 승인을 요청할 수 있습니다. 작업을 승인하기 전에 대상 폴더와 파일 이름을 주의 깊게 검토하세요.

코드 조사 및 수정

관련 프로젝트 폴더를 열거나 액세스 권한을 부여한 다음 Capri에 구체적으로 요청하세요.

이 프로젝트의 버그를 찾고 원인을 설명한 다음 수정하고 사용 가능한 검사를 실행해 줘.

선택한 AI 엔진이 코드를 검사하고, 문제로 보이는 부분을 찾고, 관련 파일을 편집하고, 검사를 실행할 수 있습니다. 더 안전하게 검토하려면 프로젝트 수정을 허용하기 전에 Capri에 제안된 변경 내용을 설명하도록 요청하세요.

문서 요약

Capri는 허용된 폴더에 있는 여러 파일을 처리할 수 있습니다. 예를 들면 다음과 같습니다.

이 폴더의 모든 PDF를 요약하고 하나의 통합 요약 문서를 작성해 줘.

작업을 승인하기 전에 Capri가 읽을 폴더와 생성된 문서를 저장하려는 위치를 확인하세요.

웹 프로젝트 생성

전체 개발 워크플로를 요청할 수도 있습니다.

이 폴더에 새 웹 앱을 설정하고 종속 항목을 설치한 다음 실행해 줘.

이러한 요청에는 파일 생성, 패키지 다운로드, 셸 명령 실행 및 프로세스 시작이 포함될 수 있습니다. 승인하기 전에 제안된 프레임워크, 명령 및 대상 디렉터리를 확인하세요.

권한 및 범위 설정

README에는 다음과 같은 구성 예시가 제공되어 있습니다.

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine 값은 연결된 어시스턴트를 선택합니다. 문서에 명시된 값으로는 claude-code, codex, antigravity, custom이 있습니다.

permissions 섹션은 다음 세 가지 모드를 지원합니다.

• ask: Capri가 작업 전에 확인을 요청합니다. 에이전트의 작동 방식을 익힐 때 가장 적합한 시작 설정입니다.
• auto: 작업이 자동으로 진행될 수 있습니다. 작업을 이해하고 범위를 엄격하게 제한한 경우에만 사용하세요.
• read-only: 변경을 허용하지 않고 Capri를 검사와 분석에 사용합니다.

allowed_folders 목록은 에이전트가 접근할 수 있는 위치를 제한합니다. 전체 드라이브나 사용자 프로필보다 특정 작업 디렉터리에 대한 접근 권한을 부여하는 것이 좋습니다.

고급 팁

명확한 경계가 있는 프롬프트 작성

대상 폴더, 원하는 결과, 검증 방법, 확인이 필요한 작업을 명시하세요. 정확한 요청은 모호함을 줄여 줍니다.

내 Projects 폴더의 프로젝트를 검토하세요. 테스트가 실패하는 원인을 파악하고 제안하는 수정 사항을 설명한 다음, 파일을 변경하기 전에 승인을 기다리세요. 승인 후 기존 테스트 모음을 실행하세요.

읽기 전용 모드로 시작

익숙하지 않은 저장소나 문서 모음에서는 read-only 접근으로 시작하세요. Capri에게 자료를 검사하고 계획을 제안하도록 요청하세요. 수정 권한을 부여할 준비가 되었을 때만 권한 모드를 변경하세요.

격리된 프로젝트 폴더 사용

실험 작업을 전용 폴더에 복사하고 Capri에는 해당 디렉터리에만 접근 권한을 부여하세요. 이렇게 하면 실수로 변경할 가능성을 줄이고 결과 파일의 차이를 더 쉽게 검토할 수 있습니다.

계획과 실행을 분리

대규모 작업에서는 먼저 변경 없이 계획을 요청하세요. 단계를 검토한 후 승인한 부분만 실행하도록 두 번째 지시를 내리세요. 이는 대량 파일 작업, 종속성 설치 또는 광범위한 리팩터링에 특히 유용합니다.

상황에 맞게 엔진 전환

Capri에서는 지원되는 여러 AI 엔진 중에서 선택할 수 있습니다. 여러 어시스턴트의 계정을 관리한다면 현재 작업에 가장 적합한 엔진을 선택하세요. 각 제공업체마다 기능, 비용, 개인정보 보호 약관이 다르다는 점을 기억하세요.

커스텀 어댑터는 신중하게 사용

커스텀 어댑터를 통해 다른 어시스턴트를 통합할 수 있습니다. 사용할 때는 인증 정보, 요청, 도구 호출 및 반환 데이터를 어떻게 처리하는지 확인하세요. README에는 어댑터 구현 지침이 없으므로 통합을 구축하기 전에 프로젝트의 최신 문서나 기여 자료를 참고하세요.

모든 로드맵 기능을 사용할 수 있다고 가정하지 않기

로드맵에는 플러그인 시스템, 음성 제어, 작업 스케줄러, 테마 갤러리, macOS 및 Linux 버전이 완료된 기능이 아니라 예정된 기능으로 나와 있습니다. 이러한 기능을 기반으로 작업 흐름을 설계하기 전에 최신 릴리스 노트를 확인하세요.

안전 지침

• 민감한 작업은 모두 검토: 삭제, 이동, 교체, 셸 명령, 종속성 설치에 특히 주의하세요.
• 폴더 접근 제한: 현재 작업에 필요한 파일만 노출하세요.
• 백업 유지: 대량 정리, 자동 편집 또는 기타 대규모 작업 전에 중요한 데이터를 백업하세요.
• 인증 정보 보호: API 키, 계정 토큰 또는 기타 비밀 정보를 절대 공유하지 마세요.
• 생성된 명령 확인: Capri가 셸 명령을 실행하도록 허용하기 전에 해당 명령을 이해하세요.
• 버전 관리 사용: 코드 프로젝트에서는 상당한 수정을 요청하기 전에 커밋하거나 다른 방법으로 현재 상태를 보존하세요.

보안 문제를 발견하면 프로젝트의 보안 취약점 신고 지침을 따르고 비공개로 신고하세요.

문제 해결 및 프로젝트 리소스

설치 프로그램, 엔진 연결 또는 에이전트 작업 흐름이 예상대로 작동하지 않으면 Capri GitHub 저장소와 최신 릴리스 노트를 확인하세요. 버그와 기능 아이디어는 프로젝트 이슈 양식을 통해 제출할 수 있습니다.

버그 신고, 문서, 테마, 기능 제안, 엔진 어댑터 등의 영역에서 기여를 환영합니다. 변경 사항을 제출하기 전에 저장소의 기여 가이드를 확인하세요.

결론

Capri는 Windows 사용자가 지원되는 AI 어시스턴트에 파일, 프로젝트 및 코드를 작업하도록 지시할 수 있는 데스크톱 인터페이스를 제공합니다. 애플리케이션을 설치하고 선호하는 엔진을 연결한 다음, 필요한 폴더에 대한 접근을 제한하고 승인 기반 또는 읽기 전용 권한으로 시작하세요. AI 에이전트가 컴퓨터에서 작업하도록 허용할 때는 명확한 프롬프트, 신중한 검토, 백업 및 제한적인 접근 경계가 필수적입니다.