본문 바로가기

Claude 출력 형식 지정하기: 표·JSON·목록으로 받기

표, JSON, 목록처럼 원하는 형식으로 답을 받는 법. 형식을 분명히 지정하고 예시로 고정하는 요령을 정리했습니다.

글갱신

같은 질문이라도 답을 표로 받느냐, JSON으로 받느냐, 줄글로 받느냐에 따라 쓰임새가 크게 달라집니다. Claude는 원하는 출력 형식을 지정하면 그 형식에 맞춰 답하므로, 형식을 분명히 알려 주는 것만으로 결과를 한결 다루기 쉽게 만들 수 있습니다.

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당

🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
0, 출력 $50)으로 이용합니다. 일회성
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
00 크레딧은 Fable 5 전환 당시에만 지급됐고 5.1에는 없습니다. 일부 코딩·디버깅 요청은 보안 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다(두 모델 공통). 자세한 내용은 Fable 5.1 가이드와 Fable 5 재개 안내를 참조하세요.

⚡ 한눈에 요약
  • 형식을 지정하면 표 · JSON · 줄글 등 원하는 대로 받습니다.
  • 예시로 형식을 고정할 수 있습니다.
  • JSON만 깔끔하게 받는 방법도 있습니다.
  • 더 엄격한 구조가 필요할 때의 팁 포함.
원하는 형식을 지정하면 그대로 답한다 프롬프트 "표로 정리해 줘" 표 JSON { } 목록

형식을 분명히 지정하기

가장 기본은 원하는 형식을 말로 정확히 지정하는 것입니다. "표로 정리해 줘", "JSON으로만 답해 줘", "번호 매긴 목록으로 줘"처럼 형식 이름을 직접 부르고, 표라면 어떤 열이 필요한지, JSON이라면 어떤 키가 필요한지까지 적어 주면 더 안정적입니다.

  • 표(table) — 항목을 비교하거나 정리할 때. 필요한 열 이름을 함께 지정합니다.
  • JSON — 프로그램에서 바로 쓰거나 데이터로 저장할 때. 키 이름과 구조를 정해 줍니다.
  • 목록(list) — 단계나 항목을 나열할 때. 번호 목록인지 글머리표인지 정합니다.

예시로 형식 고정하기

형식이 복잡하거나 매번 똑같은 모양으로 받아야 한다면, 원하는 형태의 예시를 하나 보여 주는 것이 가장 확실합니다. Claude가 예시의 구조를 그대로 따라 답하기 때문입니다. 이 방식은 예시 주기(퓨샷)와 같은 원리입니다.

다음 표 형식으로 정리해 줘.
| 이름 | 특징 | 추천 용도 |
| --- | --- | --- |
| (여기에 채워 줘) |

JSON만 깔끔하게 받기

JSON을 코드에서 바로 쓰려는데 "다음은 요청하신 JSON입니다" 같은 설명이 앞에 붙으면 처리하기 번거롭습니다. 이때는 "설명 없이 JSON만 출력해 줘"처럼 군더더기를 빼라고 분명히 지시합니다. 필요한 키와 값의 형태를 미리 정해 두면 결과가 더 안정적입니다.

API를 쓴다면, assistant 응답의 첫 부분을 미리 채워 두는 프리필(prefill)로 답을 { 부터 시작하게 만들 수 있습니다. 그러면 앞에 설명 문장이 붙지 않습니다. 이는 웹·앱 채팅에는 없는 API 전용 기능입니다.

더 엄격한 구조가 필요하면

유효한 JSON이 항상 보장되어야 하는 경우라면, 프롬프트만으로는 가끔 형식이 어긋날 수 있으니 출력을 검증하는 단계를 두는 편이 안전합니다. API에서는 도구 사용(tool use)으로 입력 스키마를 정의하면 Claude가 그 구조에 맞춰 값을 채우므로, 형식을 더 단단하게 강제할 수 있습니다.

형식을 안정적으로 받는 3단계 ① 형식 이름 표·JSON·목록 ② 예시로 고정 원하는 모양 1개 ③ 군더더기 빼기 "설명 없이"

정리하면, 형식 이름을 분명히 부르고 · 필요하면 예시로 고정하고 · 군더더기를 빼라고 지시하는 세 가지만 챙겨도 대부분의 형식 문제는 해결됩니다. 더 자세한 작성 요령은 Anthropic 공식 문서를 참고하세요.

자주 묻는 질문

출력 형식을 어떻게 지정하나요?

"표로 정리해 줘", "JSON으로 줘", "세 문단으로" 처럼 원하는 형식을 분명히 말하면 그에 맞춰 답합니다.

JSON만 깔끔하게 받으려면요?

"설명 없이 JSON만 출력"이라고 지정하고, 원하는 키 구조를 예시로 보여 주면 군더더기 없이 받기 쉽습니다.

형식이 잘 안 지켜질 때는요?

원하는 형식의 예시를 한두 개 함께 주면 형식이 고정됩니다. 더 엄격하면 스키마를 명시하세요.

같은 작업을 코드에서 자동화한다면 Claude API 구조화된 출력으로 JSON 스키마를 강제할 수 있습니다.

긴 문서를 먼저 요약한 뒤 형식을 지정하려면 Claude로 문서 요약하기를 함께 보세요.

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요