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

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

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

원하는 형식을 지정하면 그대로 답한다 프롬프트 "표로 정리해 줘" JSON { } 목록

형식을 분명히 지정하기

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

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

예시로 형식 고정하기

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

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

JSON만 깔끔하게 받기

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

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

더 엄격한 구조가 필요하면

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

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

이어서 읽어보세요

궁금한 점이 있거나 활용법을 나누고 싶나요?

커뮤니티에서 다른 사용자들과 팁과 노하우를 나눠보세요. 더 많은 가이드도 준비되어 있어요.