AI 튜토리얼

Capri AI 튜토리얼: Claude Code, Codex 등을 위한 데스크톱 에이전트 설정

Windows에서 Capri AI를 다운로드하고 구성하는 방법, AI 엔진 연결, 데스크톱 작업의 안전한 승인, 파일 정리, 코드 수정, 문서 요약, 자동화 생성과 같은 실용적인 작업을 수행하는 방법을 알아보세요.

2026년 11월 4일약 10분 소요

Capri AI 튜토리얼: Claude Code, Codex 등을 위한 데스크톱 에이전트 설정

Capri AI란?

Capri AI는 Claude Code, Codex, Antigravity 및 기타 AI 어시스턴트를 하나의 인터페이스에서 사용할 수 있도록 지원하는 Windows 데스크톱 애플리케이션입니다. 터미널과 별도의 도구를 오갈 필요 없이 자연어로 목표를 설명하면, 연결된 어시스턴트가 Capri를 통해 작업을 계획하고 수행합니다.

Capri는 파일과 프로젝트 폴더를 다루고, 셸 명령과 애플리케이션을 사용하며, 웹과 상호 작용하고, 코드를 작성 및 실행하고, 자동화를 만들 수 있습니다. 민감한 작업이 실행되기 전에 검토할 수 있도록 승인 단계도 제공합니다.

주요 기능

다양한 AI 엔진: Claude Code, Codex, Antigravity 및 사용자 지정 어시스턴트 어댑터 간에 전환할 수 있습니다.
데스크톱 네이티브 워크플로: 터미널에서 직접 작업하지 않고 그래픽 애플리케이션을 사용할 수 있습니다.
파일 및 프로젝트: Capri에 프로젝트 폴더 전체에서 파일을 찾고, 읽고, 정리하고, 편집하고 작업하도록 요청할 수 있습니다.
에이전트 도구: 선택한 엔진이 작업을 계획하고, 도구를 사용하고, 결과를 확인하고, 보고하도록 할 수 있습니다.
코드 지원: 선택한 엔진을 통해 코드를 작성하고, 리팩터링하고, 디버깅하고, 실행할 수 있습니다.
자동화: 반복적인 작업을 하나의 자연어 요청으로 처리할 수 있습니다.
승인 제어: Capri가 작업을 수행하기 전에 검토하거나 거부할 수 있습니다.
음성 및 데스크톱 존재감: 입력하거나 음성으로 Capri와 대화하고, 선택 사항인 “Hey Capri” 호출 문구를 사용하며, 사이버펑크 스타일의 데스크톱 화면을 사용자 지정할 수 있습니다.

시스템 요구 사항 및 다운로드

Capri는 현재 Windows 10 이상에서 사용할 수 있습니다. macOS 및 Linux 버전은 계획되어 있지만 아직 제공되지 않습니다.

최신 Windows 릴리스는 Capri 릴리스 페이지에서 다운로드할 수 있습니다. README에는 설치 없이 모든 폴더에서 실행할 수 있는 포터블 ZIP 패키지가 안내되어 있습니다. 설치 프로그램 패키지의 이름은 Capri-Setup.exe로 문서에 명시되어 있습니다.

설치 및 첫 실행

1. Windows 빌드 선택

Capri를 특정 폴더에 보관하거나 설치 없이 실행하려면 포터블 빌드를 사용하세요. 일반적인 Windows 설치 과정과 시작 메뉴 항목을 원한다면 설치 프로그램을 사용하세요.

2. Capri 설치 또는 압축 해제

설치 프로그램을 사용하는 경우 Capri-Setup.exe를 실행하고 설치 마법사의 안내를 따르세요.
포터블 버전을 사용하는 경우 Capri-Portable.zip을 원하는 폴더에 압축 해제하세요.
Capri를 실행하세요. 설치 프로그램을 사용했다면 Windows 시작 메뉴에서 열 수 있습니다.

Windows SmartScreen에서 애플리케이션의 다운로드 횟수가 많지 않다는 경고를 표시할 수 있습니다. 파일을 저장소의 공식 Releases 페이지에서 받았다면 More info를 선택한 다음 Run anyway를 선택하세요.

3. AI 어시스턴트 연결

처음 실행하면 Capri에서 사용할 어시스턴트를 묻습니다. Claude Code, Codex 또는 Antigravity와 같이 사용 가능한 엔진을 선택하세요. 그런 다음 계정에 로그인하거나 필요한 API 키를 입력하세요. 다른 어시스턴트는 사용자 지정 어댑터를 통해 연결할 수 있습니다.

Capri 요청 처리 방식

Capri는 간단한 상호 작용 모델을 사용합니다.

목표 설명: 원하는 작업을 일반적인 언어로 입력하거나 음성으로 전달합니다.
요청 전달: Capri가 선택한 AI 엔진으로 요청을 보냅니다.
작업 계획: 엔진이 필요한 단계와 도구를 결정합니다.
작업 검토: 승인 모드가 활성화되어 있으면 Capri가 민감한 작업을 승인 대상으로 표시합니다.
실행 및 보고: Capri가 승인된 작업을 수행하고 결과를 보고합니다.

도구 계층은 파일과 프로젝트, 셸 명령과 애플리케이션, 웹을 다룰 수 있습니다. Esc를 눌러 진행 중인 작업을 중단할 수도 있습니다.

실용적인 사용 예시

폴더 정리

Downloads 폴더를 정리하려면 다음과 같이 요청하세요.

내 Downloads 폴더를 정리하고 모든 항목을 유형별로 그룹화해 줘.

Capri는 폴더를 검사하고 계획을 제안한 다음, 작업을 승인하면 파일을 이동할 수 있습니다. 파일을 이동하거나 이름을 바꾸도록 허용하기 전에 제안된 변경 사항을 주의 깊게 검토하세요.

프로젝트 디버깅

프로젝트 폴더를 열거나 참조한 뒤 다음과 같이 요청하세요.

이 프로젝트에서 버그를 찾아 수정해 줘.

연결된 엔진이 코드를 읽고, 문제가 발생했을 가능성이 높은 부분을 찾고, 패치를 적용하고, 검사를 실행할 수 있습니다. 올바른 프로젝트 디렉터리에 접근할 수 있는지 확인하고 변경 사항을 수락하기 전에 검토하세요.

문서 요약

PDF가 들어 있는 폴더에는 다음과 같이 요청할 수 있습니다.

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

Capri는 파일을 읽고 통합 요약을 만들 수 있습니다. 폴더에 연결된 AI 제공업체로 전송해도 되는 문서만 들어 있는지 확인하세요.

웹 앱 생성 및 실행

새 개발 프로젝트를 시작하려면 다음과 같이 요청해 보세요.

새 웹 앱을 설정하고 실행해 줘.

어시스턴트가 프로젝트의 기본 구조를 만들고, 종속성을 설치하고, 앱을 실행할 수 있습니다. 이 요청은 파일을 만들고 명령을 실행할 수 있으므로 승인 모드를 사용하고 제안된 각 작업을 검토하세요.

반복 작업 만들기

반복되는 작업을 자연스럽게 설명할 수 있습니다:

매주 월요일에 Documents 폴더를 백업해 줘.

README에는 자동화가 사용 가능한 기능으로 나와 있습니다. 그러나 로드맵에는 전용 작업 스케줄러도 예정된 기능으로 표시되어 있으므로, 정확한 반복 작업 구현은 현재 릴리스에 따라 달라질 수 있습니다.

권한 구성

Capri의 예시 구성에서는 엔진 선택, 권한 모드, 허용된 폴더 및 시각적 테마를 사용합니다:

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

permissions:
  mode: ask                # ask before acting | auto | read-only
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

ask 모드는 Capri가 작업 전에 확인을 요청하므로 가장 안전한 시작점입니다. 변경 없이 분석만 원할 때는 read-only 모드가 유용합니다. 예시에는 작업을 자동으로 실행할 수 있는 auto도 표시되어 있습니다. 이 모드는 위험을 이해하고 접근 가능한 폴더를 제한한 경우에만 사용하세요.

더 안전한 워크플로를 위한 고급 팁

권한을 좁게 설정하세요: 현재 작업에 필요한 Documents, Projects 또는 기타 폴더에만 접근을 허용하세요.
승인을 활성화하세요: 무엇이든 삭제, 이동, 덮어쓰기 또는 실행하기 전에 제안된 작업을 확인하세요.
중요한 데이터를 백업하세요: 대규모 파일 작업이나 광범위한 자동화 요청을 실행하기 전에 백업을 만드세요.
자격 증명을 보호하세요: API 키, 계정 토큰 또는 기타 비밀 정보를 다른 사람과 절대 공유하지 마세요.
요청을 명확하게 작성하세요: 대상 폴더, 예상 결과, 제한 사항 및 Capri가 파일을 수정해도 되는지를 명시하세요.
필요하면 중단하세요: 작업이 진행 중일 때 Esc를 눌러 Capri를 중지하세요.
제공업체 정책을 확인하세요: 요청은 연결한 AI 어시스턴트를 통해 처리되며, 해당 제공업체의 약관과 개인정보 보호정책이 적용됩니다.

음성, 메모리 및 데스크톱 기능

Capri는 입력 대화와 음성 채팅을 지원하며, 선택적으로 “Hey Capri” 호출어를 사용할 수 있습니다. Capri는 80개 언어로 응답할 수 있고, 자체 무료 음성, 사용자가 제공하는 음성 모델 또는 Fish Audio, ElevenLabs, OpenAI와 같은 지원 서비스를 사용해 말할 수 있습니다.

프로젝트 설명에 따르면 이 애플리케이션은 PC에서 과거 대화와 화면에 표시된 정보를 보관할 수 있습니다. README에는 정확한 데이터 처리 세부 사항이 아직 문서화 중이라고 나와 있으므로, 연결된 제공업체의 개인정보 보호정책을 확인하고 민감한 정보가 노출되지 않도록 하세요.

Capri에는 사이버펑크 테마의 인터페이스, 창문 위나 화면 하단 근처에 배치할 수 있는 데스크톱 캐릭터, 음악을 위한 Windows 미니 플레이어도 포함되어 있습니다.

현재 지원 및 로드맵

현재 지원되는 엔진은 Claude Code, Codex 및 Antigravity입니다. 다른 어시스턴트는 사용자 지정 어댑터를 통해 사용할 수 있습니다. Windows 설치 프로그램과 포터블 애플리케이션, 여러 AI 엔진 및 음성 제어는 로드맵에서 완료된 항목으로 표시되어 있습니다.

예정된 항목에는 macOS 및 Linux 버전, 플러그인 시스템, 작업 스케줄러, 모바일 동반 앱, 커뮤니티 사이버펑크 테마 갤러리가 포함됩니다. 기능을 요청하려면 프로젝트의 이슈 트래커를 통해 제출하세요.

결론

Capri AI는 지원되는 코딩 어시스턴트를 파일, 프로젝트, 애플리케이션, 코드, 음성 대화 및 자동화를 처리하는 데스크톱 중심 에이전트로 전환합니다. 시작하려면 Windows 릴리스를 다운로드하고, 어시스턴트를 연결한 뒤, 권한을 제한하고, 쉽게 검토할 수 있는 작은 작업부터 시작하세요. 모든 데스크톱 에이전트와 마찬가지로 명확한 지시, 신중한 승인 및 안정적인 백업을 사용할 때 최상의 결과를 얻을 수 있습니다.

Capri는 Cyberpunk: Edgerunners에서 영감을 받은 사이버펑크 미학의 독립적인 비공식 팬 프로젝트입니다. CD PROJEKT RED, Studio Trigger, Netflix 또는 기타 권리 보유자와 제휴하거나 이들의 승인을 받은 프로젝트가 아닙니다.