※본 기사는 Claude Code를 사용하여 작성되었습니다.

이런 적 없으신가요

Claude Code에게 작업을 요청하고 있으면, 판단이 필요한 상황에서 반드시 이렇게 물어봅니다.

"이 설정은 환경 변수로 관리해야 할까요, 아니면 Secrets Manager에 두는 것이 좋을까요? 또한, 명명 규칙(Naming Convention)에 대해서도 희망 사항이 있다면 알려주세요."

……길다. 그리고 자유 기술(Free text) 방식이라, 이쪽도 일일이 문장으로 대답해야 합니다.

Claude Code에는 AskUserQuestion이라는 **선택지를 제시하여 사용자에게 고르게 하는 툴(Tool)**이 갖춰져 있습니다. 화살표 키로 선택만 하면 되기 때문에 템포가 차원이 다르게 좋아집니다. 다만, 가만히 두면 이를 사용하지 않고 문장으로 물어오는 경우가 많습니다.

이 기사에서는 그것을 모든 프로젝트에서 영구적으로 선택지 형식으로 만들게 하는 설정 방법을 정리합니다.

~/.claude/CLAUDE.md에 작성하기

결론:

## 사용자 확인 방법
판단을 구할 때는 자유 기술로 질문하지 말고
반드시 AskUserQuestion 툴을 사용하여 선택지를 제시할 것.
...

이것뿐입니다. 파일이 없다면 새로 생성해도 무방합니다.

왜 '그곳'인가 — 설정 작성 위치 비교

Claude Code에 영구적인 지시를 내리는 장소는 크게 3가지가 있습니다. 효과가 다르므로 정리해 보겠습니다.

CLAUDE.md로는 안 되는가

프로젝트 단위로 작성하는 것이 안 되는 것은 아니지만, 리포지토리마다 작성해야 합니다. "Claude와의 상호작용 선호도"는 프로젝트 고유의 정보가 아니라 사용자 고유의 정보이므로, 유저 글로벌(User Global) 측에 두는 것이 논리적입니다.

여러 리포지토리를 가로지르는 워크스페이스 구성으로 작업하는 경우, 프로젝트 측에 작성하면 한쪽에서만 적용되는 사고가 발생할 수도 있습니다.

메모리 기능에 기억시키는 것은 안 되는가

이 부분이 가장 빠지기 쉬운 함정입니다.

Claude Code에게 "앞으로는 선택지로 물어봐 줘"라고 전달하면, 메모리에 기록해 주는 경우가 있습니다. 실제로 저도 기록되었습니다.

하지만 메모리 내용은 <system-reminder> 블록에 들어간 **배경 컨텍스트 (Background Context)**로서 전달됩니다. 이는 "참고 정보"이지 "명령"이 아닙니다. 반면 CLAUDE.md는

IMPORTANT: These instructions OVERRIDE any default behavior and you MUST follow them exactly as written.

이라는 강력한 전제와 함께 읽힙니다.

즉, 메모리는 기억하지만 따르지 않을 수 있다는 것입니다. 영구적으로 지키게 하고 싶은 행동 규칙은 CLAUDE.md 측에 작성해야 한다는 것이 실무적인 결론입니다.

실제로 어떻게 변하는가

동일한 내용을 묻는 경우로 비교해 보겠습니다.

Before: 문장으로 물어볼 때

오늘 점심에 대해 확인 부탁드립니다.
후보로는 라면, 초밥, 카레, 메밀국수가 있습니다.
라면은 면과 스프의 조합이 무한하며, 후루룩 먹어도 허용되는
...

읽기가 힘듭니다. 게다가 대답하려면 이쪽도 문장을 입력해야 합니다.

After: 선택지로 물어볼 때

동일한 정보량임에도 한눈에 파악할 수 있습니다.

관전 포인트는 3가지가 있습니다.

선택지에 설명문이 붙음 — 라벨 아래에 한 줄의 보충 설명이 들어가므로, 트레이드오프(Trade-off)를 읽으면서 선택할 수 있습니다. 문장 버전에서 길게 늘어놓았던 내용이 선택지에 연결된 형태로 정리되어 있습니다.

여러 질문을 탭으로 묶을 수 있음 — 상단의 "점심 / 휴식 / 여행지 / BGM"이 그것입니다. 관련 질문을 한 번에 던질 수 있으므로, 한 문제씩 왕복할 필요가 없습니다. 문장 버전 마지막에 있던 "함께 ~도 알려주세요"가 제대로 대답할 수 있는 형태로 바뀌어 있습니다.

Other가 항상 준비됨 — 제시된 선택지 중 어느 것도 해당하지 않는 경우에는 자유 기술도 가능합니다. 선택지 형식으로 바꾸더라도 이쪽의 선택 폭은 좁아지지 않습니다.

조작은 화살표 키와 Enter, 그리고 Esc입니다.

로 취소할 수 있습니다.

작성 팁

지시는 "선택지로 물어봐줘"라고만 해도 효과가 있지만, 다음 두 가지 점을 추가하면 경험이 더욱 좋아집니다.

1. 권장안을 맨 앞에 두게 하기

Claude 측에 판단 근거가 있다면, 그것을 첫 번째 선택지로 만들게 합니다. 대개 그것을 선택하고 끝나기 때문에, Enter 한 번으로 끝납니다.

2. "너무 많이 묻는 것"도 억제하기

반대로, 사소한 것까지 전부 선택지로 물어보면 번거로워집니다. 필요하다면 다음 문장을 추가해 둡니다.

단, 관례적인 기본값(default)이 존재하는 선택이나
코드를 읽으면 판단할 수 있는 사항은 질문하지 말고,
직접 결정하여 결과를 보고할 것.

요약

• Claude Code의 질문을 선택지 형식으로 만들고 싶다면 ~/.claude/CLAUDE.md에 작성한다.
• 프로젝트의 CLAUDE.md는 리포지토리(Repository) 단위이므로 개인의 취향에는 적합하지 않다.
• 메모리(Memory) 기능은 배경 컨텍스트(Background Context)로 취급되므로, 행동 규칙을 강제하기에는 힘이 부족하다.
• "권장안을 맨 앞에", "사소한 것은 묻지 말 것"을 덧붙이면 더욱 쾌적해진다.

작은 설정이지만, 하루에도 몇 번씩 발생하는 상호작용이기에 효과는 큽니다. 추천합니다.

Discussion