Levo 도움말 · 시작하기
내 AI 에이전트 연결하기
Levo에는 자체 두뇌가 없어요. 찾은 것을 이미 쓰고 있는 에이전트 CLI에 넘기고, 무엇을 안전하게 정리하거나 종료할 수 있는지는 그 에이전트가 판단해요. 연결은 1분이면 돼요.
사용할 수 있는 에이전트
Claude Code, Codex, Gemini CLI, Antigravity CLI, Cursor CLI, GitHub Copilot CLI, opencode, Qwen Code, Kimi CLI, Grok CLI. 직접 입력한 다른 명령도 쓸 수 있어요. 에이전트를 열어 둘 필요는 없어요. 필요할 때 Levo가 백그라운드에서 실행하고, 내 요금제나 API 키로 동작해요.
연결하기
- 평소처럼 에이전트를 설치하고 터미널에서 한 번 로그인하세요.
- Levo의 Settings › Agent를 여세요. Levo가 찾은 에이전트가 목록에 나와요. 쓰는 것을 고르세요.
- 원하면 Model과 Effort를 고르세요. Default를 선택하면 에이전트 자체 선택을 따라요.
- Test를 누르세요. Levo가 에이전트에 아주 작은 작업을 맡겨서 잘 연동되는지 확인해요.

에이전트가 목록에 없으면 Test 옆의 화살표를 눌러 다시 찾으세요. 프리셋에 없는 에이전트는 Custom…을 선택하고 명령을 입력하세요. 작업이 들어갈 자리에는 {prompt_file}, Levo의 읽기 전용 도구가 들어갈 자리에는 {mcp_config}을 쓰세요.
Claude 데스크탑 앱만 있다면
Claude 데스크탑 앱 안의 Claude Code는 그 앱에서만 작동해요. Levo에는 터미널의 Claude Code가 필요해요. 터미널을 열고 아래 줄을 붙여 넣은 뒤 Return을 누르세요.
curl -fsSL https://claude.ai/install.sh | bash
그다음 claude를 입력하고 같은 Claude 계정으로 로그인한 뒤, Levo의 Settings › Agent에서 Claude Code를 선택하세요.
한 번의 실행에 한도 두기
| Time per run | 한 번의 실행에 걸릴 수 있는 최대 시간이에요. 이 시간이 지나면 Levo가 에이전트를 멈춰요. |
|---|---|
| Steps per run | 에이전트가 한 번의 실행에서 할 수 있는 단계 수예요. |
| Runs per day | 하루에 Levo가 에이전트를 실행할 수 있는 최대 횟수예요. 한도에 도달하면 내일까지 기다려요. |
| Pause on battery | Mac이 배터리로 동작하고 잔량이 이 수준 아래일 때는 실행을 보류해요. |
에이전트가 할 수 있는 일과 할 수 없는 일
에이전트는 읽기만 할 수 있어요. 모든 실행은 쓰기를 막는 macOS 샌드박스 안에서 이뤄지고, 보호된 폴더에는 접근할 수 없으며, Levo와는 읽기 전용 도구로만 소통해요. 에이전트의 답은 데이터로만 취급하고 지시로 취급하지 않아요. 에이전트가 읽은 내용은 에이전트 자체의 제공업체로, 내 계정으로 전송돼요. 개인정보 보호를 참고하세요.
문제가 생겼을 때
Test가 이유를 짧게 알려 줘요. Not signed in: 터미널에서 에이전트를 열어 로그인하세요. Out of usage: 초기화될 때까지 기다리거나 크레딧을 추가하세요. Timed out: Time per run을 늘리세요. 그래도 실패하면 에이전트 테스트가 실패해요를 참고하세요.