가이드

AI로 코드 오류를 설명하는 방법

복사·붙여넣기 루프를 건너뛰고 오류를 캡처해 무슨 일이 있었는지 물으세요.

TL;DR

Loqua로 AI에게 코드 오류를 설명시키는 실전 가이드입니다. 오류가 나타난 곳을 캡처하고 자연스럽게 질문하면 보이는 코드, 스택 트레이스, 주변 맥락이 함께 전달됩니다. AI 분석은 개발자의 판단을 대체하는 것이 아니라 문제를 본 순간부터 다음 확인 지점을 아는 순간까지의 마찰을 줄입니다.

90초 설정

  1. Loqua를 다운로드해 /Applications로 옮깁니다.
  2. 활성 앱과 함께 작동하도록 손쉬운 사용 권한을 허용합니다.
  3. 설정에서 단축키를 확인합니다. 기본값은 Fn 받아쓰기, Fn + Space AI 질문, Fn + ↑ 번역, Left Shift + A + Command (⌘) 스크린샷 Q&A입니다.
  4. 오류가 보이는 IDE, 터미널, 브라우저를 엽니다.
  5. 오류를 캡처하고 질문한 뒤 계속 작업합니다.

모든 단축키는 변경할 수 있습니다.

흐름을 깨지 않고 오류 질문하기

Cursor에서 여러 파일을 바꾼 뒤 앱이 멈췄습니다. IDE에는 스택 트레이스, 강조된 코드, 실패 위치가 보입니다. 기존 방식은 오류 복사 → AI 채팅 열기 → 붙여넣기 → 변경 설명 → 대기입니다.

오류 메시지는 맥락의 일부일 뿐입니다. 파일, 강조된 줄, 주변 코드, 현재 작업 상태가 더 중요한 경우가 많습니다.

캡처
IDE의 오류, 강조된 코드, 파일 위치와 주변 맥락.
질문
“이 오류의 원인은 무엇이고, 무엇을 먼저 확인해야 해?”
Loqua 답변
컴포넌트가 처리하기 전에 API 응답이 예상치 못한 값을 반환했을 수 있습니다. 응답 구조를 먼저 확인하세요. 배열을 기대하지만 실제 값은 undefined일 수 있습니다.

오류를 보고, 질문하고, 계속 디버깅합니다. Loqua는 이미지를 고립된 파일로 보지 않고 스크린샷 이해, 음성 입력, 작업 맥락을 함께 사용합니다.

일반적인 디버깅 상황

IDE 오류 설명

“가장 가능성 높은 근본 원인과 먼저 볼 줄은 어디야?”라고 묻습니다.

낯선 메시지 이해

“쉽게 설명하고 어떤 조건이 이 오류를 만들었는지 알려줘.”라고 묻습니다.

수정 방향 찾기

“가장 작고 안전한 수정은 무엇이고 어떤 테스트로 확인할 수 있어?”라고 이어갑니다. 큰 변경은 제안을 출발점으로 삼고 직접 검토합니다.

음성 후속 질문

“응답이 비어 있어도 실패할까?”, “공개 API를 바꾸지 않고 방어하려면?”처럼 이어 물으면 같은 오류를 다시 설명할 필요가 없습니다.

스크린샷 Q&A가 잘 맞는 때

IDE 오류, 터미널 출력, 브라우저 콘솔, CI/CD 로그, 문서, 기술 도식처럼 필요한 정보가 이미 화면에 보일 때 사용합니다.

“두 번째 로그인 뒤에만 저장이 실패한다”처럼 보이지 않는 동작이 핵심이면 직접 음성으로 설명하는 편이 낫습니다. 모든 문제에 스크린샷이 필요한 것이 아니라 화면에 빠진 맥락이 들어 있는지 판단하는 것이 중요합니다.

자주 묻는 질문

Loqua가 AI로 스크린샷을 분석할 수 있나요?
네. 화면의 보이는 정보를 이해하고 그 맥락을 바탕으로 답합니다.
Loqua는 AI 스크린샷 분석기인가요?
그보다 넓습니다. 화면 캡처, 음성 질문, 현재 작업 맥락을 결합합니다.
코딩 오류 수정도 도와주나요?
오류 설명, 원인 후보, 수정 제안을 제공할 수 있지만 적용 전 검토와 검증은 개발자가 해야 합니다.
오류 메시지를 먼저 복사해야 하나요?
아니요. 오류가 보이는 곳을 캡처하고 질문한 뒤 계속 디버깅하면 됩니다.

오늘 Loqua를 사용해 보세요

무료로 시작하세요. Mac 네이티브. 매일 사용하는 알고리즘 연구자들이 만들었습니다.

Mac용 다운로드

Loqua 블로그 더 보기

가이드
맥에서 코드를 받아쓰기로 작성하는 법: Cursor, VS Code, Claude Code 완전 가이드
가이드
AI 코딩을 위한 음성 입력: 타이핑 없이 Cursor와 Claude Code에 음성 프롬프트
Engineering
멀티모달 음성 인식: 보이는 것을 보는 리스너 만들기