Claude Code의 대화형 질문 도구 — 익숙한 기능인데 품질이 다르다

다들 Claude Code 잘 쓰고 계시는지. 최근 v2.0.21(10월 18일)에 추가된 기능이 너무 편해서 공유한다. 바로 대화형 질문 도구다.

작업 요청에 대해 대화형으로 답을 주고받으며 사용자의 의도를 파악하게 해 주는 기능이다. 비슷한 기능을 이미 경험해 봤기에 식상할 수도 있겠지만, 직접 써 보니 대화의 품질이 아주 좋다.

왜 이 기능이 필요한가

우리가 아는 바이브코딩은 컨텍스트, 즉 문맥이 부족하다. 그래서 많은 분들이 “바이브 코딩이 잘 된다던데 왜 나는 잘 안 될까?” 하고 묻는다.

흔히 바이브 코딩은 명확한 컨텍스트나 상세 지침 없이 AI가 문맥을 파악해 주기를 기대하며 요청하는 방식을 뜻한다. 그런데 이렇게 하면 AI가 사용자의 정확한 의도나 기존 코드베이스의 복잡한 맥락을 잡지 못해 만족스럽지 못한 결과로 이어지기 쉽다. 경험이 많은 개발자라도 초기에는 바이브 코딩으로 시작할 수 있지만, 결국 원하는 결과를 얻으려면 상세한 지침을 추가로 주며 품질을 높이는 반복 작업을 거치게 된다.

대화형 질문 도구는 이 문제를 풀기 위한 장치로 보인다. AI가 추측하는 대신 되묻는다.

실제로 써 본 사례

AI TOP 100 사이트에 적용한 간단한 사례다. 이미 대회 종료 후 사용 기록을 보여 주는 페이지(/end, 인증 필요)가 구현돼 있었다. 하지만 로그인이나 기존 결과와 상관없이, 단순히 대회 종료를 안내하는 새로운 공개용 종료 페이지가 필요했다.

Claude Code에 이렇게만 요청했다.

대회가 종료되었어. 종료 페이지 추가해.

이전 버전이라면 기존 /end 페이지를 고치거나 임의의 페이지를 만들었을 수 있다. 하지만 업데이트된 Claude Code는 관련 코드를 분석한 뒤 2단계에 걸친 상세한 질문을 제시했다.

1단계 — 구현 방식 결정

이미 /end 페이지가 있다는 사실을 인지하고, 신규 페이지의 구현 방식을 명확히 하려고 물어 왔다. 화살표 키로 원하는 옵션을 고른다.

대회 종료 페이지를 어떻게 구현할까요? 현재 시스템에는 이미 '/end' 페이지(인증 필요, 제출 기록 표시)가 있습니다.

1. 환경변수로 전역 종료 설정
   NEXT_PUBLIC_COMPETITION_CLOSED=true 설정으로 모든 접속을 대회 종료 페이지로 리다이렉트. 빠르고 간단하게 적용 가능.

2. 시간 기반 자동 판단
   대회 종료 시간(endDateTime)을 체크하여 자동으로 종료 페이지로 이동. 수동 설정 불필요.

3. 새로운 공개 종료 페이지 ✅
   로그인 없이 접근 가능한 새로운 대회 종료 안내 페이지 생성. 기존 /end 페이지는 그대로 유지

4. 직접 타이핑

여기서는 3번을 골랐다.

2단계 — 참여자 페이지 처리

다음으로, 신규 종료 페이지가 생기면 기존 로그인 사용자를 어떻게 처리할지 물었다.

대회 참여자(로그인한 사용자)가 접속했을 때 어떤 페이지를 보여줄까요?

1. 제출 기록 페이지(/end)
   기존 end 페이지로 리다이렉트하여 제출 기록과 향후 일정 표시

2. 간단한 종료 안내만 ✅
   제출 기록 없이 '대회가 종료되었습니다' 메시지만 표시

3. 직접 타이핑

2번을 골랐다.

3단계 — 최종 검토

선택이 끝나면 고른 내용을 요약해 보여 주고 최종 실행 여부를 확인한다. 이 단계에서 ’뒤로 가기’로 이전 선택을 고칠 수도 있다.

Review your answers
• 대회 종료 페이지를 어떻게 구현할까요? 현재 시스템에는 이미 '/end' 페이지(인증 필요, 제출 기록 표시)가 있습니다.
> 새로운 공개 종료 페이지

• 대회 참여자(로그인한 사용자)가 접속했을 때 어떤 페이지를 보여줄까요?
> 간단한 종료 안내만

Ready to submit your answers?
1. Submit answers ✅
2. Cancel

Submit을 고르면, 확인된 명확한 지침(새 공개 페이지 생성, 간단한 안내 메시지만 포함)에 따라 작업이 진행되고 코드가 생성된다. 결과물은 여기에 있다.

결과적으로 상세한 추가 지시 없이도 복잡한 요구사항을 명확히 파악하고 의도에 맞는 결과물을 얻을 수 있었다.

무엇이 달라진 것인가

이번 업데이트는 단순한 편의 기능 추가를 넘어 AI 코딩 어시스턴트의 패러다임 변화를 시사한다.

바이브 코딩의 한계 극복 — 모호한 초기 요청을 AI가 ’추측’해 작업하는 방식의 근본적 한계를 푼다. 추측 대신 질문으로 컨텍스트를 잡는다
수동적 조수에서 능동적 협업자로 — 기존 AI가 상세한 지시를 기다리는 조수에 가까웠다면, 이제는 코드베이스를 분석하고 능동적으로 대안을 제시하며 의도를 명확히 하는 협업자로 진화하고 있다
커뮤니케이션 비용 감소 — 정확한 맥락을 전하려고 프롬프트를 다듬는 데 쓰던 시간을, 이제는 AI가 제시하는 명확한 선택지를 고르는 데 쓴다

요약하면 Claude Code는 이제 사용자의 불명확한 의도를 코드의 구체적인 맥락 안에서 명확하게 정의하는 대화형 인터페이스를 갖게 됐다. 개발자가 더 복잡하고 추상적인 요청을 해도 AI가 성공적으로 수행할 기반이 되며, 결과적으로 생산성과 결과물의 품질이 함께 올라가는 효과를 기대할 수 있다.