Claude Code 상세 사용법 14: Output style로 답변 방식을 고정하기 | DAKER 커뮤니티

Claude Code 상세 사용법 14: Output style로 답변 방식을 고정하기

Claude Code 공식 Output styles 문서는 output style을 응답 방식, 역할, 기본 출력 형식을 바꾸는 기능으로 설명한다. 중요한 점은 권한 모드가 아니라는 것이다. Proactive 스타일을 써도 도구 실행 권한이 자동으로 열리는 것은 아니며, 설정과 권한은 별도로 관리해야 한다.

1. 반복 프롬프트를 스타일로 옮긴다

매번 같은 말을 하고 있다면 output style 후보로 볼 수 있다.

공식 문서는 output style을 시스템 프롬프트를 조정하는 장치로 설명한다. 그래서 한 번의 작업 지시보다 넓고, 프로젝트 메모리보다 말투와 출력 계약에 가깝다.

2. 기본 스타일을 목적별로 고른다

Default는 일반 소프트웨어 작업에 맞다. Explanatory는 구현 선택과 코드베이스 패턴을 배우고 싶을 때 유용하다. Learning은 사람이 일부 코드를 직접 채우는 학습 모드에 가깝고, TODO(human) 표시가 들어갈 수 있다. 현재 공식 문서에는 Proactive도 포함되어 있으며, 반복 결정에서 덜 멈추고 바로 실행하는 성향을 준다.

다만 운영 코드에서는 Proactive를 켜더라도 "어디까지 자동 진행할지"를 프롬프트나 설정으로 따로 적어야 한다. style은 행동 톤을 바꾸지만, 배포나 secret 접근 같은 위험 판단을 없애지 않는다.

3. 바꾸는 방법은 /config가 기준이다

공식 Output styles 문서 기준으로 standalone /output-style 명령은 더 이상 기준 경로가 아니다. /config에서 Output style을 고르거나 settings 파일의 outputStyle 값을 직접 설정한다.

{
  "outputStyle": "Explanatory"
}

문서상 output style은 시스템 프롬프트 일부라서 실행 중 설정 파일을 고쳐도 바로 모든 답변에 반영된다고 기대하면 안 된다. /clear 또는 새 세션 이후 반영되는 것으로 설계하는 편이 안전하다.

4. 커스텀 스타일은 코딩 지시 유지 여부가 핵심이다

Senior takeaway: Output style은 "이번 답변을 예쁘게 써줘"가 아니라 반복되는 응답 계약을 Claude Code 세션 기본값으로 올리는 기능이다. 권한, 메모리, slash command, subagent와 구분해서 쓰면 팀의 바이브코딩 결과물이 더 예측 가능해진다.

커스텀 output style은 Markdown 파일이다. frontmatter와 지시문을 쓰고, 사용자 범위나 프로젝트 범위에 저장한다. 코딩 작업에도 계속 쓸 스타일이라면 keep-coding-instructions: true를 명시하는 것이 중요하다. 이 값을 빼면 Claude Code의 기본 소프트웨어 엔지니어링 지시가 유지되지 않을 수 있다.

---
name: Reviewer first
description: Always report risk and verification before implementation detail
keep-coding-instructions: true
---

팀에서는 "리뷰 우선", "교육용", "운영 자동화 보고"처럼 2~3개만 두는 편이 낫다. 스타일이 너무 많으면 선택 비용이 늘고, 같은 작업을 서로 다른 말투로 처리해 리뷰 기록이 흔들린다.

5. settings 우선순위를 같이 본다

공식 Settings 문서는 managed settings, command line arguments, local project, shared project, user settings 순서의 우선순위를 설명한다. 팀에서 output style이 예상과 다르게 동작하면 먼저 /status로 어떤 설정 소스가 읽혔는지 확인한다. 개인의 ~/.claude/settings.json보다 프로젝트 설정이나 관리형 정책이 우선할 수 있다.

아래 Mermaid는 글의 핵심 판단 흐름을 그대로 옮긴 것이다. DAKER 커뮤니티 글에서는 Mermaid 원문을 코드블록으로 남기고, 바로 아래에 같은 흐름을 SVG로 렌더링해 모바일에서도 깨지지 않게 보여준다.

Redirecting to Claude Code 상세 사용법 14: Output style로 답변 방식을 고정하기 | DAKER 커뮤니티...