Capri 튜토리얼: Windows 데스크톱에 사이버펑크 AI 에이전트 설정하기

Capri란 무엇인가요?

Capri는 사이버펑크 스타일의 Windows용 AI 에이전트입니다. Claude Code, Codex, Antigravity와 같은 AI 어시스턴트를 위한 네이티브 데스크톱 인터페이스와 에이전트 계층을 제공합니다. 터미널에서만 작업하는 대신 자연어로 목표를 설명하면 Capri가 선택한 어시스턴트로 요청을 전달하고, 도구를 조정하며, 결과를 보고합니다.

Capri는 파일, 프로젝트 폴더, 코드, 셸 명령, 애플리케이션 및 웹 관련 작업을 처리할 수 있습니다. 개발자뿐 아니라 데스크톱에서 범용 어시스턴트를 사용하려는 사람들을 위해 설계되었습니다.

현재 이 앱은 Windows 10 이상에서 사용할 수 있습니다. macOS와 Linux 지원은 예정되어 있지만 아직 제공되지 않습니다.

주요 기능

• 다양한 AI 엔진: Claude Code, Codex, Antigravity 또는 사용자 지정 어댑터를 통한 다른 어시스턴트를 사용할 수 있습니다.
• 데스크톱 네이티브 인터페이스: 터미널 전용 워크플로 대신 그래픽 애플리케이션에서 작업할 수 있습니다.
• 파일 및 프로젝트 작업: Capri에 파일과 폴더를 찾고, 읽고, 정리하고, 편집하거나 분석하도록 요청할 수 있습니다.
• 에이전트 워크플로: Capri는 작업을 계획하고, 도구를 사용하고, 결과를 확인하며, 수행한 작업을 설명할 수 있습니다.
• 코드 지원: 선호하는 엔진으로 코드를 작성하고, 리팩터링하고, 디버깅하고, 실행할 수 있습니다.
• 자동화: 반복적인 작업을 자연어 요청으로 처리할 수 있습니다.
• 승인 제어: 민감한 작업을 검토한 뒤 실행 전에 승인하거나 거부할 수 있습니다.
• 사이버펑크 인터페이스: 어둡고 네온에서 영감을 받은 데스크톱 환경을 사용할 수 있습니다.

Windows에 Capri 설치하기

1. 릴리스 다운로드

최신 Capri 릴리스를 열고 사용 가능한 Windows 패키지 중 하나를 선택합니다.

• Capri-Setup.exe: 일반적으로 설치하고 시작 메뉴 바로 가기를 만들려면 설치 프로그램을 사용합니다.
• Capri-Portable.zip: 설치하지 않고 폴더에서 Capri를 실행하려면 포터블 빌드를 사용합니다.

2. 애플리케이션 실행

설치 프로그램 버전은 Capri-Setup.exe를 실행하고 설정 마법사를 완료한 다음 시작 메뉴에서 Capri를 엽니다. 포터블 버전은 Capri-Portable.zip을 폴더에 압축 해제한 뒤 해당 폴더에서 애플리케이션을 실행합니다.

Capri는 최신 애플리케이션이므로 Windows SmartScreen에 경고가 표시될 수 있습니다. 저장소의 공식 Releases 페이지에서 파일을 다운로드했다면 추가 정보를 선택한 다음 실행을 선택합니다.

3. AI 어시스턴트 연결

처음 실행하면 Capri에서 사용할 어시스턴트를 선택하라는 메시지가 표시됩니다. 사용 가능한 엔진을 선택한 다음 계정에 로그인하거나 필요한 API 키를 입력합니다. Capri는 기본적으로 Claude Code, Codex, Antigravity를 지원합니다. 다른 어시스턴트는 사용자 지정 어댑터를 통해 연결할 수 있습니다.

선택한 엔진에 따라 요청을 처리하는 AI 시스템이 결정되며, Capri는 데스크톱 인터페이스, 라우팅, 도구 및 승인 워크플로를 제공합니다.

첫 작업 실행하기

자연어로 목표 설명

Capri가 수행할 작업을 설명하는 구체적인 요청으로 시작합니다. 예를 들면 다음과 같습니다.

내 다운로드 폴더를 정리하고 파일 형식별로 그룹화해 줘.

Capri는 폴더를 스캔하고 계획을 제안한 뒤, 작업을 승인하면 파일을 이동할 수 있습니다. 첫 테스트에는 대체할 수 없는 데이터가 포함되지 않은 폴더를 사용하세요.

코딩 작업 시도

Capri는 연결된 엔진을 사용해 프로젝트를 검사하고, 문제를 찾고, 코드를 수정하고, 검사를 실행할 수 있습니다. 다음과 같이 요청할 수 있습니다.

이 프로젝트에서 버그를 찾아 원인을 설명하고 수정한 다음 기존 검사를 실행해 줘.

파일을 변경하거나 명령을 실행하는 작업인 경우, 승인하기 전에 제안된 작업을 검토하세요.

문서 작업

Capri에 여러 파일을 처리하고 통합 결과를 만들도록 요청할 수도 있습니다.

이 폴더의 모든 PDF를 하나의 문서로 요약해 줘.

어시스턴트는 Capri에 제공된 권한과 액세스 범위 내에서 파일을 읽고 통합 요약을 작성할 수 있습니다.

Capri의 요청 처리 방식

1. 목표 설명: 자연어로 요청을 입력합니다.
2. 요청 전달: Capri가 선택한 AI 엔진으로 요청을 보냅니다.
3. 작업 계획: 엔진이 필요한 단계와 도구를 결정합니다.
4. 승인 요청: Capri는 민감한 작업을 승인할 기회를 제공합니다.
5. 실행 및 보고: Capri가 관련 도구를 사용하고 결과를 보고합니다.

도구 계층은 파일과 프로젝트, 셸과 애플리케이션 및 웹 관련 작업을 처리할 수 있습니다. 승인 단계는 시스템이나 데이터가 변경될 수 있는 작업에 사용자가 계속 관여하도록 하기 위한 것입니다.

엔진 선택 및 전환

Capri는 Claude Code, Codex 및 Antigravity를 직접 지원합니다. README에는 사용자 지정 어댑터를 통한 다른 어시스턴트 지원도 설명되어 있습니다. 작업에 가장 적합한 엔진을 사용하고, 다른 어시스턴트가 더 적합할 때 전환하세요.

예를 들어 코딩 워크플로에는 한 엔진을 사용하고 일반적인 데스크톱 작업에는 다른 엔진을 사용할 수 있습니다. 정확한 로그인 또는 API 키 절차는 연결하는 어시스턴트 제공업체에 따라 다릅니다.

권한 및 인터페이스 구성

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

engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # 실행 전 확인 | 자동 | 읽기 전용
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine 설정은 연결된 어시스턴트를 선택합니다. 권한 모드는 실행 전에 확인하거나, 자동으로 실행하거나, 읽기 전용 액세스를 사용하도록 구성할 수 있습니다. allowed_folders 목록은 Capri가 액세스할 수 있는 위치를 제한하며, 인터페이스 설정은 사이버펑크 테마를 선택합니다.

애플리케이션을 익히는 동안에는 제한적인 설정을 사용하세요. mode: ask로 시작하고 작업에 필요한 폴더만 허용하세요.

고급 사용법 및 자동화 팁

작업 범위를 정확하게 지정하세요

좋은 요청에는 위치, 원하는 결과, 제한 사항이 포함됩니다. Capri에 모든 항목을 정리해 달라고 요청하는 대신 폴더를 지정하고 항목을 어떻게 그룹화할지 설명하세요. 그러면 제안된 계획을 더 쉽게 검토할 수 있습니다.

반복 작업은 신중하게 자동화하세요

Capri는 반복 작업을 한 문장으로 처리할 수 있도록 설계되었습니다. 프로젝트의 예로는 새 웹 앱을 설정하고 실행하는 작업, Documents 폴더의 반복 백업을 요청하는 작업 등이 있습니다. 지속적인 워크플로를 활성화하기 전에 실행 결과를 검토하고 대상 위치와 파일이 올바른지 확인하세요.

로드맵에는 작업 스케줄러가 별도 예정 항목으로 기재되어 있으므로, 출시된 애플리케이션에서 모든 일정 관리 기능을 현재 사용할 수 있다고 가정하지 마세요.

필요할 때 사용자 지정 어댑터를 사용하세요

선호하는 어시스턴트가 기본 제공 엔진 중 하나가 아니라면, 프로젝트에서는 다른 어시스턴트를 연결하는 방법으로 사용자 지정 어댑터를 안내합니다. 사용자 지정 통합을 계획하기 전에 현재 릴리스 문서와 저장소 이슈에서 구현 세부 정보를 확인하세요.

안전 권장 사항

• 승인 전에 작업을 검토하세요: 파일 삭제, 이동, 덮어쓰기 및 셸 명령에 특히 주의하세요.
• 폴더 액세스를 제한하세요: 현재 작업에 필요한 디렉터리에만 Capri의 액세스를 허용하세요.
• 백업을 유지하세요: 대규모 작업이나 자동화 작업을 실행하기 전에 중요한 데이터를 백업하세요.
• 자격 증명을 보호하세요: API 키, 계정 토큰 또는 기타 인증 정보를 절대 공유하지 마세요.
• 제공업체 정책을 확인하세요: 요청은 연결한 AI 어시스턴트가 해당 제공업체의 약관과 개인정보 보호정책에 따라 처리합니다.

Capri는 작업을 검토할 수 있도록 설계되었지만, 데스크톱 자동화 도구에 위험이 전혀 없을 수는 없습니다. 승인 메시지를 불편한 절차가 아니라 보안 경계로 여기세요.

문제 해결 및 지원

Windows에서 애플리케이션을 차단하는 경우 SmartScreen 우회를 사용하기 전에 프로젝트의 공식 Releases 페이지에서 다운로드했는지 확인하세요. 어시스턴트가 연결되지 않으면 선택한 엔진, 로그인 상태, API 키 또는 계정 자격 증명을 확인하세요.

기능 요청이나 문제 제보는 저장소의 이슈 트래커를 이용하세요. 프로젝트 로드맵에는 macOS 및 Linux 버전, 플러그인 시스템, 모바일 동반 앱, 커뮤니티 사이버펑크 테마 갤러리가 포함되어 있습니다.

결론

Capri는 Windows 데스크톱 인터페이스를 이미 사용 중인 AI 어시스턴트와 결합합니다. 설치 프로그램 또는 포터블 빌드를 다운로드한 후 엔진을 연결하고 작업을 설명한 다음, Capri가 파일, 프로젝트 및 애플리케이션을 다루도록 허용하기 전에 제안된 작업을 검토하세요. 제한된 권한과 간단한 요청으로 시작한 뒤, 코딩 워크플로와 신중하게 검토한 자동화로 점차 확장하세요.