Claude Code AskUserQuestion으로 AI에게 질문받는 방법 – 모호한 요청 줄이는 실전 사용법

여러분 이거 경험 있죠?

Claude한테 “로그인 기능 만들어줘” 했는데 뭔가 내가 원한 거랑 다르게 나오는 거.

“아니 OAuth는 왜 넣었어?” 하면 Claude는 “아 그럼 이메일 로그인으로 바꿀게요” 하고 또 다시 짜고.

이렇게 왔다 갔다 하면서 시간 버리는 거.

저도요.

처음엔 제 설명이 부족한 줄 알았어요. “아 내가 더 자세히 설명했어야 했는데” 하면서 프롬프트를 길게 쓰고 그랬거든요.

근데 말이죠.

AI가 먼저 물어보게 만들 수 있으면 어떨까요?

“로그인 어떻게 구현할까요? OAuth? 이메일? 소셜?” 이렇게 선택지 주면서요.

“그런 게 어딨어?” 싶죠?

있어요. 진짜로. AskUserQuestion

---

Claude Code의 AskUserQuestion이 뭔데?

AskUserQuestion… 뭔 소린지 모르겠죠?

쉽게 말할게요.

“AI가 일 시작하기 전에 먼저 질문하는 기능”

끝. 이게 전부예요.

2025년 2월 Claude Code v2.0.21부터 추가된 기능인데요, Claude가 작업 중에 “이거 어떻게 할까요?” 하면서 객관식 질문을 던집니다. 우리가 선택하면 그대로 진행하고요.

ChatGPT랑 뭐가 다르냐고요?

핵심 차이는 이거예요:

구분	기존 AI 코딩	Claude Code AskUserQuestion
작업 방식	AI가 추측해서 일단 만듦	먼저 물어보고 시작
수정 횟수	평균 2-3번 왔다 갔다	처음부터 정확하게
의사소통	사용자가 다시 설명	AI가 구조화된 질문

기존 AI는 “이 정도면 원하는 거겠지?” 하고 추측해서 만들어요.

근데 AskUserQuestion은 확실하지 않으면 물어봐요.

추측? 안 함.

왜 이게 중요하냐면요. 개발할 때 한 번 잘못 짜면 나중에 뜯어고치기 진짜 힘들잖아요. 처음부터 제대로 물어보고 시작하면 그런 삽질이 줄어듭니다.

---

실제로 어떻게 동작하는지 볼까요?

제가 직접 써본 예시 보여드릴게요.

시나리오 1: 로그인 기능 구현

사용자: "로그인 기능 만들어줘"

Claude (AskUserQuestion 사용):
┌─────────────────────────────────────────┐
│ 🔐 Authentication                       │
│                                         │
│ Q1. 어떤 인증 방식을 사용할까요?        │
│ ○ OAuth 2.0 (Google, GitHub 등)        │
│ ○ 이메일/비밀번호 (직접 구현)          │
│ ○ Magic Link (이메일 링크 로그인)      │
│ ○ Other (직접 입력)                    │
│                                         │
│ Q2. 세션 관리는 어떻게 할까요?          │
│ ○ JWT (Recommended)                    │
│ ○ Session Cookie                       │
│ ○ Other                                │
│                                         │
│ [60초 내 선택하세요]                    │
└─────────────────────────────────────────┘

이거 보세요.

Claude가 “이메일 로그인이겠거니” 하고 추측하는 게 아니라 먼저 물어봐요.

OAuth 쓸지, 이메일 쓸지, 심지어 Magic Link 쓸지까지 선택지를 줍니다.

저는 처음 이거 봤을 때 “아 이게 진짜 필요했던 거구나” 싶었어요.

시나리오 2: API 엔드포인트 설계

사용자: "사용자 관리 API 만들어줘"

Claude (AskUserQuestion):
┌─────────────────────────────────────────┐
│ 🛠️ API Design                            │
│                                         │
│ Q1. REST 스타일은?                      │
│ ○ RESTful (/users/:id)                 │
│ ○ GraphQL (Recommended)                │
│ ○ gRPC                                 │
│                                         │
│ Q2. 에러 응답 형식은?                   │
│ ○ RFC 7807 Problem Details            │
│ ○ 커스텀 JSON 형식                     │
│ ○ Other                                │
│                                         │
│ Q3. 페이지네이션은?                     │
│ ○ Offset-based (?page=1&limit=10)     │
│ ○ Cursor-based (Recommended)          │
│ ○ Other                                │
└─────────────────────────────────────────┘

근데 진짜 웃긴 게요.

이 질문들이 제가 생각 못한 것들이거든요. “아 맞다 페이지네이션 방식도 정해야지” 이런 거 까먹고 있다가 Claude가 물어봐줘서 “아 그래 이것도 결정해야 했네” 하게 돼요.

AI가 제 빈틈을 채워주는 느낌?

---

기술 스펙 – 알아야 할 제약사항

자, 이제 좀 기술적인 얘기 해볼게요.

AskUserQuestion이 만능은 아니거든요. 제약사항이 있어요.

1. 60초 타임아웃

가장 중요한 제약입니다.

질문이 뜨면 60초 안에 대답해야 해요. 60초 넘으면 Claude가 “아 답 안 주네? 그럼 내가 알아서 할게” 하고 넘어갑니다.

60초 타이머 시작
  ↓
[30초 경과]
  ↓
[50초 경과] ⚠️ 곧 타임아웃!
  ↓
[60초 초과] → Claude가 자동으로 기본값 선택

솔직히 처음엔 이거 좀 빡쳤어요.

“아니 생각 좀 하고 선택하게 해줘야지 왜 60초야?” 했거든요.

근데 써보니까 이유가 있더라고요. 너무 오래 기다리면 Claude 세션이 끊어질 수 있어서 그런 거래요.

꿀팁: “Type something else…” 옵션 누르면 타이머 멈춰요. 그때 천천히 생각하고 입력하시면 됩니다.

2. 세션당 4-6개 질문 제한

한 세션에서 무한정 질문할 수 있는 게 아니에요.

대략 4-6개 정도 질문하면 더 이상 AskUserQuestion이 안 나옵니다.

작업 복잡도	예상 질문 수	실제 경험
간단한 기능	2-3개	로그인 폼: 2개 질문
중간 복잡도	4-5개	REST API: 5개 질문
복잡한 시스템	6개+	6개 이후 질문 안 나옴

제가 한 번은 복잡한 대시보드 만들 때 질문이 8개쯤 필요했거든요.

근데 6개까지만 물어보고 나머지는 Claude가 알아서 결정해버리더라고요.

“아 이것도 물어봐줘야 하는데” 하는 거 있었는데 못 물어본 거죠.

그래서 지금은 복잡한 프로젝트는 여러 세션으로 나눠서 진행해요.

3. 하위 에이전트에서는 사용 불가

Claude Code는 복잡한 작업을 하위 에이전트에게 위임할 수 있잖아요?

근데 하위 에이전트는 AskUserQuestion을 못 써요.

오직 메인 Claude만 질문할 수 있어요.

❌ 안되는 경우:
Main Claude
  → Sub Agent A (AskUserQuestion ❌)
  → Sub Agent B (AskUserQuestion ❌)

✅ 되는 경우:
Main Claude (AskUserQuestion ✅)
  → Sub Agent A (물어볼 거 없이 실행만)
  → Sub Agent B (물어볼 거 없이 실행만)

이게 왜 문제냐면요.

큰 프로젝트에서 “프론트엔드는 Agent A, 백엔드는 Agent B” 이렇게 나눠서 시키면 각 Agent가 세부사항 못 물어봐요.

그래서 저는 이렇게 해요:

1. 메인 Claude가 AskUserQuestion으로 전체 스펙 다 받아냄
2. 그 스펙을 하위 에이전트들한테 넘김
3. 하위 에이전트들은 스펙대로만 실행

이렇게 하면 문제없어요.

4. 질문 구조 제한

한 번에 1-4개 질문까지 가능하고, 각 질문은 2-4개 옵션을 제공해야 해요.

질문 제한:
- 최소: 1개 질문
- 최대: 4개 질문
- 권장: 2-3개 (너무 많으면 사용자 피곤함)

옵션 제한:
- 최소: 2개 선택지
- 최대: 4개 선택지
- 항상 "Other" 옵션 자동 추가됨

처음엔 “왜 4개까지만?” 했는데 써보니까 이유 알겠더라고요.

5개, 6개 이렇게 많으면 선택하기 힘들어요. 4개가 딱 적당해요.

---

실전 사용법 – Spec 기반 개발 워크플로우

자, 이제 진짜 중요한 부분입니다.

AskUserQuestion을 제대로 쓰는 방법이요.

제가 2025년 12월부터 2개월간 실제로 써본 워크플로우예요.

STEP 1: 최소한의 프롬프트로 시작

❌ 나쁜 예:
"로그인 기능 만들어줘. OAuth 2.0 쓰고, Google이랑 GitHub 연동하고,
JWT로 세션 관리하고, Redis로 토큰 저장하고..."

→ 너무 구체적이면 Claude가 물어볼 게 없어요.

✅ 좋은 예:
"사용자 인증 시스템 만들어줘"

→ 간단하게! Claude가 알아서 물어봅니다.

핵심은 애매하게 시작하는 거예요.

“어? 그럼 더 헷갈리는 거 아니야?” 싶죠?

아니에요. 오히려 이게 정답이에요.

애매하게 시작해야 Claude가 “아 이거 불확실하네? 물어봐야겠다” 하고 질문을 던져요.

처음엔 이게 어색했는데 지금은 익숙해졌어요.

STEP 2: Claude가 인터뷰하게 만들기

최소 프롬프트 주면 Claude가 질문 폭탄 날립니다.

Claude:
┌─────────────────────────────────────────┐
│ 🎯 Project Scope                        │
│                                         │
│ Q1. 사용자 규모는?                      │
│ ○ 소규모 (100명 이하)                  │
│ ○ 중규모 (100-10,000명)                │
│ ○ 대규모 (10,000명+) (Recommended)     │
│                                         │
│ Q2. 보안 요구사항은?                    │
│ ○ 기본 수준 (이메일 인증)              │
│ ○ 중간 수준 (2FA 필요)                 │
│ ○ 높은 수준 (금융권 수준)              │
│                                         │
│ Q3. 배포 환경은?                        │
│ ○ 클라우드 (AWS, GCP 등)               │
│ ○ 온프레미스                           │
│ ○ 하이브리드                           │
└─────────────────────────────────────────┘

이거 보세요.

제가 생각 못한 것들까지 물어봐요.

“아 맞다 사용자 규모에 따라 DB 설계가 달라지지” 이런 거 까먹고 있다가 Claude가 물어봐줘서 “아 그래 이것도 결정해야 했네” 하게 돼요.

저는 처음 이 워크플로우 써봤을 때 충격받았어요.

“AI가 내 빈틈을 채워주네?”

STEP 3: 답변하면서 Spec 문서 자동 생성

여기가 핵심입니다.

Claude가 물어보는 거 다 대답하면, Claude가 자동으로 스펙 문서를 만들어줘요.

# 사용자 인증 시스템 설계 스펙

## 1. 프로젝트 개요
- 규모: 중규모 (100-10,000명)
- 보안 수준: 중간 (2FA 포함)
- 배포: AWS 클라우드

## 2. 기술 스택
- 인증: OAuth 2.0 (Google, GitHub)
- 세션: JWT + Redis
- DB: PostgreSQL

## 3. 주요 기능
- 소셜 로그인 (Google, GitHub)
- 이메일 인증
- 2FA (TOTP 방식)
- 비밀번호 재설정

## 4. API 엔드포인트
POST /auth/login
POST /auth/logout
POST /auth/refresh
GET /auth/me

## 5. 보안 요구사항
- JWT 만료: 15분
- Refresh Token 만료: 7일
- 비밀번호 정책: 최소 8자, 특수문자 포함

이게 진짜 게임 체인저예요.

왜냐면 이 스펙 문서를 다음 세션에 그대로 쓸 수 있거든요.

STEP 4: 새 세션에서 스펙 기반 실행

스펙 문서 받았으면 새 세션 시작하세요.

새 세션:
"위 스펙대로 사용자 인증 시스템 구현해줘"

→ Claude가 질문 안 하고 바로 정확하게 만들어줌

왜 새 세션이냐고요?

첫 번째 세션은 질문으로 4-6개 다 써버렸잖아요. 새 세션에서 시작하면 질문 카운트가 리셋돼요.

그리고 스펙이 명확하니까 Claude가 추측할 게 없어요. 그냥 스펙대로 코딩만 하면 돼요.

저는 이 방식 쓰고 나서 수정 요청이 70% 줄었어요.

진짜예요. 처음부터 제대로 만들어주니까 “아니 이거 아닌데” 하는 일이 거의 없어졌어요.

---

Plan 모드와 함께 쓰면 더 강력해요

Claude Code의 Plan 모드 아시죠?

코딩하기 전에 계획을 먼저 세우는 모드인데요.

AskUserQuestion이랑 궁합이 찰떡이에요.

Plan 모드 + AskUserQuestion 워크플로우

STEP 1: Plan 모드 시작
사용자: "사용자 인증 시스템 계획 세워줘"

STEP 2: Claude가 질문 폭탄
[AskUserQuestion으로 요구사항 수집]

STEP 3: 계획서 작성
Claude: "이렇게 계획했어요:
1. DB 스키마 설계
2. 인증 로직 구현
3. API 엔드포인트 생성
4. 테스트 작성"

STEP 4: 계획 승인 후 실행
사용자: "좋아, 진행해"
→ Claude가 계획대로 정확하게 실행

Plan 모드 없이 그냥 쓰면 Claude가 중간중간 “이거 어떻게 할까요?” 물어봐요.

근데 Plan 모드랑 같이 쓰면 계획 단계에서 다 물어보고, 실행 단계에서는 질문 없이 쭉쭉 진행해요.

제가 써본 경험상 이게 제일 효율적이더라고요.

---

꿀팁 모음 – 2개월 써보고 알게 된 것들

1. “Type something else…” 옵션 활용

60초 타임아웃 부담스럽죠?

“Type something else…” 선택하면 타이머 멈춰요.

질문 나옴
  ↓
[타이머 60초 시작...]
  ↓
"Type something else..." 클릭
  ↓
[타이머 정지!]
  ↓
천천히 생각하고 입력

저는 처음에 몰라서 60초 안에 급하게 선택했거든요.

근데 이 옵션 알고 나서는 여유롭게 생각하고 답해요.

2. Ctrl+G로 외부 에디터 사용

“Other” 입력 필드에서 Ctrl+G 누르면 외부 에디터 열려요.

긴 설명 써야 할 때 유용해요.

Other 입력 필드
  ↓
Ctrl+G 누름
  ↓
VSCode/Vim/Nano 등 외부 에디터 열림
  ↓
편하게 긴 텍스트 작성
  ↓
저장하면 자동으로 입력됨

솔직히 이거 모르면 Other 필드에 긴 글 쓰기 진짜 힘들어요.

3. “(Recommended)” 옵션을 먼저 시도

Claude가 “(Recommended)” 붙여주는 옵션 있잖아요?

일단 그거 선택하고 시작하세요.

Q1. 세션 관리는?
○ JWT (Recommended)  ← 이거 선택
○ Session Cookie
○ Other

Claude가 코드베이스 분석해서 가장 적합한 옵션에 Recommended 붙여줘요.

제 경험상 Recommended 선택하면 90% 문제없어요.

나중에 조정 필요하면 그때 바꾸면 돼요.

4. 복잡한 프로젝트는 세션 나누기

질문 6개 제한 있으니까 복잡한 프로젝트는 나눠서 진행하세요.

세션 1: 인증 시스템 (질문 5개)
  ↓
스펙 문서 생성
  ↓
세션 2: API 엔드포인트 (질문 4개)
  ↓
스펙 문서 생성
  ↓
세션 3: 프론트엔드 (질문 5개)
  ↓
최종 통합

한 세션에서 다 하려고 하면 나중에 질문 못 하고 Claude가 추측해버려요.

나눠서 하면 각 세션마다 질문 카운트 리셋되니까 충분히 물어볼 수 있어요.

---

실제 사용 케이스 – 제가 직접 써본 것들

Case 1: 대시보드 프로젝트

상황: 관리자 대시보드 만들어야 하는데 요구사항이 애매했어요.

기존 방식:
"대시보드 만들어줘" → Claude가 알아서 만듦
→ "아 차트는 이렇게 말고..." → 수정
→ "테이블 정렬은..." → 또 수정
→ 총 4번 왔다 갔다

AskUserQuestion 사용:
"대시보드 만들어줘"
→ Claude 질문: 차트 라이브러리? 테이블 기능? 반응형?
→ 답변 후 바로 정확하게 구현
→ 수정 요청 0번

시간 절약: 약 2시간

Case 2: REST API 설계

상황: 사용자 관리 API 만들어야 하는데 스펙이 없었어요.

Claude 질문:
Q1. REST 스타일은? → RESTful 선택
Q2. 에러 형식은? → RFC 7807 선택
Q3. 페이지네이션은? → Cursor-based 선택
Q4. 인증 방식은? → JWT 선택
Q5. Rate Limiting은? → 필요 선택

결과:
→ 스펙 문서 자동 생성
→ 새 세션에서 스펙대로 구현
→ API 문서까지 자동 생성됨

혼자 스펙 짜는 시간: 약 3시간 절약

Case 3: DB 스키마 설계

상황: 전자상거래 DB 설계해야 하는데 경험 없어서 막막했어요.

Claude 질문:
Q1. 결제 방식은? → 단건 결제
Q2. 재고 관리는? → 실시간 재고 추적
Q3. 주문 상태는? → 상세 상태 (결제대기/배송중 등)
Q4. 사용자 등급은? → 일반/VIP 2단계

결과:
→ ERD 자동 생성
→ 테이블 관계 명확하게 정의됨
→ 인덱스 전략까지 제안받음

초보자가 스스로 설계했으면 며칠 걸렸을 것 같아요.

---

주의사항 – 이건 꼭 알아야 해요

1. 타임아웃 압박감

60초 제한이 생각보다 빡빡해요.

❌ 실수하기 쉬운 상황:
- 회의 중에 질문 나옴 → 집중 못 함 → 타임아웃
- 화장실 갔다 옴 → 질문 못 봄 → 기본값 선택됨
- 복잡한 질문 → 생각할 시간 부족 → 잘못 선택

✅ 해결책:
- 집중할 수 있는 시간에 작업
- "Type something else..." 활용
- 급하면 Recommended 선택 후 나중에 조정

저도 한 번 화장실 갔다가 타임아웃 되어서 Claude가 알아서 결정한 적 있어요.

나중에 보니까 제가 원한 거랑 달라서 다시 짜야 했거든요.

지금은 AskUserQuestion 나올 만한 작업은 집중 가능한 시간에만 해요.

2. 질문 개수 제한

세션당 4-6개 제한이 은근히 빡빡해요.

❌ 문제 상황:
복잡한 프로젝트 → 질문 10개 필요
→ 6개까지만 물어봄
→ 나머지는 Claude가 추측
→ 나중에 "어? 이거 왜 이렇게 했어?" 발생

✅ 해결책:
- 프로젝트를 단계별로 나눔
- 각 단계마다 새 세션
- 단계별 스펙 문서 작성

처음엔 이 제한 몰라서 한 세션에서 다 하려고 했거든요.

근데 질문 6개 넘어가니까 더 이상 안 물어보고 알아서 결정하더라고요.

지금은 처음부터 단계별로 나눠서 진행해요.

3. 하위 에이전트 제한

메인 Claude만 질문 가능한 거 꼭 기억하세요.

❌ 예상과 다른 상황:
"프론트엔드랑 백엔드 각각 만들어줘"
→ 하위 에이전트들이 세부사항 못 물어봄
→ 추측해서 만듦
→ 수정 요청 폭탄

✅ 올바른 접근:
"프론트엔드랑 백엔드 스펙 먼저 잡아줘"
→ 메인 Claude가 전체 스펙 다 물어봄
→ 스펙 완성 후 하위 에이전트에 전달
→ 하위 에이전트는 스펙대로만 실행

이거 모르면 “왜 안 물어보고 알아서 만들어?” 하게 돼요.

---

내가 느낀 점 – 솔직한 후기

2025년 12월부터 2개월간 AskUserQuestion 써봤는데요.

솔직히 처음엔 “이거 귀찮은 거 아니야?” 했어요.

일일이 질문에 답해야 하잖아요. 그냥 Claude한테 알아서 만들라고 하는 게 편할 것 같았거든요.

근데 막상 써보니까 생각이 완전히 바뀌었어요.

달라진 것들

1. 수정 요청이 70% 줄었어요

기존: “아니 이거 아닌데” → 수정 → “이것도 아닌데” → 또 수정 지금: 처음부터 제대로 나와서 수정 거의 안 함

2. 내가 생각 못한 것들을 챙기게 됐어요

Claude가 “이것도 결정해야 해요” 하고 물어보면 “아 맞다 이것도 있었네” 하게 돼요.

제 실력이 늘어나는 느낌이에요.

3. 스펙 문서 작성하는 습관이 생겼어요

예전엔 머릿속으로만 대충 생각하고 바로 코딩 시작했거든요.

지금은 Claude랑 질문-답변하면서 자연스럽게 스펙이 만들어져요.

나중에 이 스펙 문서가 진짜 유용해요. 다른 사람한테 공유할 때도 좋고요.

아쉬운 점

완벽하진 않아요. 아쉬운 것들도 있어요.

1. 60초 타임아웃이 좀 짧아요

복잡한 질문은 60초로 부족해요. “Type something else…” 옵션으로 해결은 되는데, 처음엔 몰라서 스트레스받았어요.

2. 질문 6개 제한이 빡빡해요

큰 프로젝트는 질문이 10개 이상 필요한데 6개까지만 되니까 여러 세션으로 나눠야 해요. 좀 번거로워요.

3. 하위 에이전트 미지원

큰 프로젝트에서 작업 나눠서 시킬 때 각 에이전트가 세부사항 못 물어봐요. 이것도 좀 아쉬워요.

---

솔직한 마음 – 불안과 방향

이거 쓰면서 든 생각이에요.

AI가 점점 사람처럼 질문하네요.

예전엔 우리가 AI한테 일방적으로 지시했잖아요. “이거 해, 저거 해”

근데 이제는 AI가 역으로 물어봐요. “이거 어떻게 할까요? 저거는요?”

마치 주니어 개발자랑 대화하는 느낌이에요.

솔직히 좀 신기하면서도 무서워요.

“AI가 계속 이렇게 발전하면 개발자가 필요 없어지는 거 아니야?” 하는 생각도 들거든요.

근데 또 써보면서 깨달은 게 있어요.

AI는 질문은 할 수 있지만, 방향은 제시 못 해요.

“OAuth 쓸까요? 이메일 쓸까요?” 물어보지만, “우리 서비스는 OAuth가 맞아요” 하고 결정하는 건 결국 사람이거든요.

AI는 도구예요. 엄청 똑똑한 도구.

근데 이 도구를 어떻게 쓸지는 우리가 정해야 해요.

그래서 저는 불안하지만 방향은 찾았습니다.

AI와 대화하는 법을 배우자.

일방적으로 지시하는 게 아니라, AI가 물어보면 제대로 답해주고, AI가 제안하면 판단하고, AI가 놓친 거 있으면 짚어주고.

이게 앞으로 개발자의 역할인 것 같아요.

---

앞으로 내가 할 것들 – 액션 플랜

AskUserQuestion 써보면서 앞으로 이렇게 할 생각이에요.

1. 모든 프로젝트는 Spec부터

기존:
아이디어 → 바로 코딩 → 수정 → 또 수정

앞으로:
아이디어 → AskUserQuestion으로 스펙 작성 → 새 세션에서 구현

스펙 먼저 잡으면 나중에 훨씬 편해요.

2. Plan 모드 필수 사용

Plan 모드 + AskUserQuestion 조합이 최강이에요.

앞으로 모든 중요한 작업은:
1. Plan 모드 켜기
2. AskUserQuestion으로 요구사항 수집
3. 계획 검토 후 실행

3. 질문 카운트 관리

세션 시작할 때 질문 몇 개 필요할지 예측하기.

6개 넘을 것 같으면 처음부터 단계 나누기.

4. 팀원들한테 공유

제가 쓰는 워크플로우를 팀원들한테 공유할 거예요.

특히 주니어 개발자들한테 유용할 것 같아요.
AskUserQuestion이 뭘 고려해야 하는지 가르쳐주거든요.

---

FAQ – 자주 묻는 질문들

Q1. AskUserQuestion은 유료 기능인가요?

아니요, Claude Code v2.0.21 이상이면 무료로 사용 가능해요.

Pro 계정도 필요 없어요. 기본 Claude Code 설치하면 바로 쓸 수 있어요.

Q2. 60초 안에 못 답하면 어떻게 되나요?

Claude가 자동으로 기본값을 선택해요. 보통 “(Recommended)” 옵션이 있으면 그걸 선택하고, 없으면 첫 번째 옵션을 선택해요.

나중에 수정할 수 있지만, 처음부터 제대로 답하는 게 좋아요.

Q3. 질문을 건너뛸 수 있나요?

네, “Type something else…” 선택 후 빈 칸으로 제출하면 건너뛸 수 있어요.

하지만 권장하지 않아요. Claude가 추측해서 만들기 때문에 나중에 수정해야 할 수 있어요.

Q4. 이미 시작한 프로젝트에도 쓸 수 있나요?

네, 가능해요.

“이 프로젝트에 기능 추가해줘” 하면 Claude가 기존 코드 분석 후 관련 질문을 던져요.

Q5. 하위 에이전트가 질문 못 하는 건 버그인가요?

아니요, 의도된 동작이에요. 공식 문서에 명시되어 있어요.

메인 Claude만 사용자에게 질문할 수 있어요.

Q6. 한국어로도 질문 나오나요?

네, Claude가 대화 언어에 맞춰서 질문해요. 한국어로 대화하면 질문도 한국어로 나와요.

Q7. 질문 형식을 커스터마이징할 수 있나요?

아니요, 질문 형식은 Claude가 자동으로 결정해요. 우리는 선택지만 고를 수 있어요.

Q8. Plan 모드 없이도 잘 작동하나요?

네, 잘 작동해요. 하지만 Plan 모드랑 같이 쓰면 더 효율적이에요.

Plan 모드는 계획 단계에서 질문을 다 하고, 실행 단계에서는 질문 없이 진행하거든요.

---

결론 – AskUserQuestion을 써야 하는 이유

2개월 써본 결론입니다.

AskUserQuestion은 선택이 아니라 필수예요.

왜냐면:

1. 수정 요청이 70% 줄어요 – 처음부터 제대로 만들어줌
2. 놓치는 것들을 챙겨줘요 – Claude가 물어봐서 빈틈 채움
3. 스펙 문서가 자동 생성돼요 – 나중에 유용함
4. 개발 실력이 늘어요 – 뭘 고려해야 하는지 배움

단점도 있어요:

• 60초 타임아웃 빡빡함
• 질문 6개 제한 아쉬움
• 하위 에이전트 미지원

하지만 장점이 훨씬 커요.

특히 Spec 기반 개발 워크플로우는 진짜 게임 체인저예요.

최소 프롬프트
  → AskUserQuestion으로 인터뷰
  → 스펙 문서 생성
  → 새 세션에서 정확하게 구현

이 워크플로우만 알아도 개발 시간 절반은 줄일 수 있어요.

저는 지금 모든 프로젝트에 이 방식 쓰고 있어요.

여러분도 한번 써보세요. 진짜 좋아요.

---

참고 자료

• Claude Code AskUserQuestion Tool Guide – SmartScope
• Claude Code’s Ask User Question Tool: First Impressions – Torq Software
• Handle approvals and user input – Claude API Docs
• What is Claude Code’s AskUserQuestion tool? – AtCyrus
• Claude Code Skills Examples: Using AskUserQuestion for Multi-Round Interviews – Jeremy Watt
• Interactive mode – Claude Code Docs
• Best Practices for Claude Code – Claude Code Docs

🏷️ 태그: #ClaudeCode #AskUserQuestion #AI코딩 #개발도구 #코드리뷰 #개발자 #프롬프트엔지니어링