Claude Code가 너무 장황하게 답변하고 에세이처럼 길게 말하는 문제를 어떻게 해결하나요?

우리 팀 엔지니어 중 한 명이 이 문제의 대부분을 해결해냈는데, 그 덕분에 내 일상적인 CC 사용 방식이 완전히 바뀌었음:

• 불평보다는 형식 규칙이 훨씬 잘 먹힘. "장황하게 하지 마"는 거의 효과가 없음. 모델은 이걸 그냥 말투에 대한 조언 정도로 받아들이거든. 진짜 효과가 있는 건 CLAUDE.md에 구체적인 기본 형식을 박아넣는 거임. 예: "기본 답변: 결과부터 말할 것, 최대 5줄. 내가 요청할 때만 확장할 것." 하지 말아야 할 행동이 아니라, 원하는 형식을 기준으로 문장을 짜야 함.

• CLAUDE.md를 줄이셈. 우리 건 규칙이 쌓이고 쌓여서 300줄 가까이 됐었는데, 준수율이…

반발하는 게 당연함. 솔직히 말해서, 이건 내가 본 문제 제기 중 가장 날카로운 분석임.

실제로 무슨 일이 벌어지고 있나

문제는 장황함 자체가 아님. 장황함이 필수적인 요소가 되어버린 게 문제임. 시니어급의 "함정"은 Opus 5가 "간결하게 하라"는 지시를 읽고, 그걸 조용히 "간결함의 전형적인 형태를 설명하라"는 식으로 재해석하는 지점에서 발생함. 그게 결정적인 증거임.

스타일 문제가 아니라, 아키텍처 문제임.

수정 사항 적용

최소한의 범위로 변경했음:

• [CLAUDE.md에 간결하게 하라를 추가함.

output-style 설정을 사용하고, 장황함에 대한 명시적인 규칙이 담긴 terse.md를 만드셈.

그다음 settings.json에 추가:

"outputStyle": "Terse",

스타일 가이드를 활용하는 것도 아주 효과적임.

Google 기술 문서 작성 스타일 가이드를 적용했더니, 내 아티팩트에서 AI 특유의 현학적인 헛소리가 즉시 사라졌음.

난 AGENTS.md/CLAUDE.md 파일에 이걸 추가함:

응답 스타일

• 질문에서 사용한 용어를 그대로 써서 답변부터 시작할 것. "무엇이 다른가"라고 물으면 차이점부터 말하셈. 답변을 평가하는 문장("X에 대해서는 맞고 Y에 대해서는 틀림")은 진짜 답변을 한 단계 아래로 묻어버림.
• 도구 호출당이 아니라 단계당 한 줄의 서술만 할 것. 중간 단계의 코멘트는 결과를 알기 전에 작성되는 거라, 최종 답변이 대체해버리는 추측에 불과함. 도구 호출은 이미 화면에 다 나와 있음.
• 형용사는… 없이…