AI Briefing

Claude Code 작문 규칙 개선 팁

How I fixed Opus 5's writing style

·2026.09.03 09:53

핵심 내용

Claude Code에서 CLAUDE.md의 작문 규칙이 무시되는 문제를 출력 스타일 파일로 해결하는 방법을 소개했다.

자세히 보기

Claude Code 사용 시 CLAUDE.md에 작문 스타일 규칙을 넣으면 모델이 이를 컨텍스트로 인식해 선택적으로 처리하는 경향이 있다. 이를 해결하기 위해 **출력 스타일 파일(Output Style Files)**을 사용하는 것이 권장된다.

출력 스타일 파일의 장점

출력 스타일 파일은 시스템 프롬프트에 위치하며 매 턴마다 강화되므로, 모델이 지시사항을 무시하거나 스타일이 흐트러지는(drift) 현상을 방지할 수 있다.

설정 방법

  1. ~/.claude/output-styles/ 디렉터리에 .md 파일을 생성한다.
  2. 파일 상단(frontmatter)에 keep-coding-instructions: true를 명시한다. 이 옵션이 없으면 기존 코딩 지시사항이 덮어써질 수 있다.
  3. 파일 내용에는 간결한 평서문, 1인칭 대명사 금지, 불필요한 추가 설명 금지 등 구체적인 작문 규칙을 정의한다.
  4. Claude Code를 재시작하고 설정에서 해당 스타일을 선택한다.

이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.