Levo 도움말 · 문제 해결
에이전트 테스트가 실패해요("Exit 1")
Settings › Agent의 Test는 에이전트에 아주 작은 작업을 맡겨서 Levo와 잘 연동되는지 확인해요. 실패하면 결과에 원인과 해결 방법이 나와요. 대부분 1분이면 고칠 수 있어요.
"Didn’t answer"와 Exit code 1
에이전트가 시작은 했지만, Levo에 답을 주지 않고 멈췄어요. 결과 위에 포인터를 올리면 종료 코드를 볼 수 있어요. Exit 1은 거의 항상 에이전트에 로그인되어 있지 않거나, 백그라운드에서는 물어볼 수 없는 것을 사용자에게 요구한다는 뜻이에요.
- 터미널을 열고 쓰는 에이전트(
claude,codex,gemini등)를 실행하세요. - 로그인, 프롬프트 승인, 폴더 신뢰를 요구하면 지금 처리하세요.
- 에이전트를 종료하고 Levo로 돌아가 Test를 다시 누르세요.
그 밖의 메시지
- Not installed.(설치되지 않음) Levo가 명령을 찾지 못해요. 에이전트를 설치한 다음, Test 옆의 원형 화살표를 눌러 다시 찾으세요. 특이한 위치에 있다면 사용자 지정 명령을 선택하세요.
- Not signed in.(로그인 안 됨) 위에서 설명한 대로 터미널에서 에이전트에 로그인하세요.
- Out of usage.(사용량 소진) 요금제나 크레딧을 다 썼어요. 초기화될 때까지 기다리거나 크레딧을 추가하세요.
- Busy.(사용량 많음) 제공업체가 요청 수를 제한하고 있어요. 몇 분 뒤에 다시 시도하세요.
- Model not available.(모델 사용 불가) 고른 모델이 요금제에 포함돼 있지 않아요. Default나 다른 모델을 선택하세요.
- Didn’t start.(시작하지 못함) 에이전트가 명령줄을 받아들이지 않았어요. 대개 버전이 오래된 탓이에요. 에이전트를 업데이트하세요. 사용자 지정 명령이라면 내용을 확인하세요.
- Stopped by macOS.(macOS가 중지함) 터미널에서 에이전트를 한 번 열어 보세요. macOS가 허용을 기다리고 있을 수 있어요.
- Timed out.(시간 초과) 에이전트가 Time per run보다 오래 걸렸어요. 다시 시도하거나 Settings › Agent에서 값을 늘리세요.
계속 실패한다면
- 에이전트가 혼자서 잘 동작하는지 확인하세요. 터미널에서 간단한 질문을 하고 답이 오는지 보세요.
- 에이전트를 최신 버전으로 업데이트하세요. Levo의 프리셋은 최신 명령줄에 맞춰져 있어요.
- 다른 에이전트를 써 보세요. 지원하는 에이전트라면 모두 쓸 수 있고, 같은 창에서 바꿀 수 있어요.
- 사용자 지정 명령을 쓰나요?
{prompt_file}이 필요하고, CLI가 MCP를 지원한다면{mcp_config}도 필요해요. MCP가 없으면 CLI가 답을 마커 사이의 JSON 블록으로 출력해야 해요.
명령줄에서
Levo의 헬퍼로도 같은 내용을 볼 수 있어요. levo agents로 찾은 항목을 나열하고, levo setup --agent claude(또는 에이전트 이름)로 선택해 테스트를 실행하세요.
그래도 해결되지 않는다면
Settings의 Send feedback을 사용하세요. 체크하면 짧은 로그가 함께 전송되고, 보내기 전에 모든 내용을 미리 볼 수 있어요. 또는 이메일로 문의하세요.