Claude Artifacts 활용법: 작은 도구를 만들고 검토하는 순서

핵심 요약: Claude Artifacts를 활용할 때는 만들 대상, 입력값, 결과, 확인 방법을 함께 적으세요. 문서나 작은 도구의 초안을 받는 것과 남에게 보여 줄 수 있는 결과를 만드는 것 사이에는 수정과 검토 단계가 필요합니다. 아래 공부 계획 도구는 설명을 위해 만든 기획 예시이며 실제 생성하거나 시험한 결과는 아닙니다.

1. Artifacts로 무엇을 요청할지 정하기

Artifacts는 대화 옆에서 열어 보고 수정하거나 다시 활용할 수 있는 결과물입니다. 공식 안내는 문서, 디자인, 대시보드, 작은 대화형 도구 등을 예로 듭니다. 제공 방식과 기능 조건은 바뀔 수 있으므로 Artifacts 공식 문서를 현재 화면과 함께 확인하세요.

시작 주제로는 숫자 입력이 적은 계획표, 설명 카드, 공개 자료만 쓰는 퀴즈처럼 결과를 쉽게 검토할 수 있는 대상을 고르는 편이 좋습니다. 처음부터 회원 관리와 결제, 여러 서비스 연결까지 요청하면 무엇이 완성됐는지 판단하기 어려워집니다. 핵심 기능 하나를 먼저 정하고 필요한 기능을 추가하세요.

2. 가상 예시: 공부 시간 나누기 도구

하루 공부 시간을 과목별로 나누는 도구를 만든다고 가정해 보겠습니다. 입력은 전체 공부 시간과 과목별 비중, 출력은 각 과목에 배정한 시간입니다. “예쁜 공부 앱”이라는 요청보다 무엇을 입력하고 무엇을 보여 줄지가 명확합니다. 먼저 계산 규칙을 글로 정해야 화면을 고칠 때도 기준을 유지할 수 있습니다.

공부 시간을 나누는 작은 도구를 Artifact로 만들어 줘.
입력: 전체 시간(분), 국어·영어·수학 비중.
출력: 과목별 시간과 전체 합계.
비중 합계가 100이 아니면 이유를 보여 주고 계산하지 마.
전체 시간이 0 이하이거나 비어 있으면 입력 안내를 보여 줘.
정수 분으로 표시하되 반올림 차이가 있으면 따로 설명해 줘.
실제 학습 효과를 보장하는 표현은 넣지 마.
먼저 계산 규칙과 확인할 예시를 보여 줘.

이 질문의 중요한 부분은 색상이나 배치보다 오류 처리와 합계입니다. 비중 합계가 틀릴 때 자동으로 조정할지 계산을 중단할지는 서로 다른 규칙이므로, 원하는 방식을 선택해서 명시하세요. 배정 시간은 계획을 정리한 수치이며 성적 향상을 뜻하지 않습니다.

3. 생성 후에는 한 번에 한 종류씩 수정하기

첫 결과를 보고 “좀 더 좋게”라고만 요청하면 계산과 디자인이 함께 바뀔 수 있습니다. “입력란 이름을 한국어로 바꾸되 계산 방식은 유지해 줘”, “오류 안내를 입력란 아래에 보여 줘”, “모바일에서 표가 잘리지 않도록 배치를 조정해 줘”처럼 수정 목적을 나누세요.

수정 전에 유지할 항목을 적어 두면 변경을 비교하기 쉽습니다. 예를 들어 합계 확인, 비어 있는 값 처리, 반올림 안내는 유지하고 글자 크기만 바꾸는 식입니다. 문서를 만들 때도 같은 원칙을 적용할 수 있습니다. 날짜와 사실은 유지한 채 제목과 문단만 고치도록 요청하세요.

4. 보기 좋은 결과와 맞는 결과를 구분하기

공부 도구의 검토용 입력으로 전체 120분, 비중 25·25·50을 넣는 경우를 생각해 보세요. 단순 비율 계산으로 기대하는 값은 30·30·60분입니다. 이는 이 글에서 정한 계산 예시이며 생성 도구가 실제로 이 값을 냈다는 뜻은 아닙니다. 사용자는 결과 화면과 기대값을 직접 비교해야 합니다.

• 빈칸, 0, 음수, 숫자가 아닌 값에서 안내가 적절한지 확인합니다.
• 비중 합계가 99 또는 101이면 정한 규칙대로 처리하는지 확인합니다.
• 전체 시간이 작은 경우 반올림 후 합계가 어떻게 표시되는지 살펴봅니다.
• 휴대전화 크기의 화면에서 입력과 결과를 읽을 수 있는지 확인합니다.
• 새로고침이나 다시 열기 후 저장된다고 생각한 정보가 실제로 남는지 확인합니다.

저장 여부는 결과물의 구현과 기능 조건에 따라 확인해야 합니다. 화면에 입력란이 있다는 이유만으로 데이터가 영구 보관된다고 가정하지 마세요. 설명문에도 확인한 기능만 적는 것이 좋습니다.

5. 공유 전에 접근 범위와 내용 확인하기

초안에는 예시 이름이나 내부 자료가 들어갈 수 있습니다. 공유 전에는 개인정보, 작업 메모, 아직 검토하지 않은 주장과 링크를 찾아 정리하세요. 공유 대상에게 어떤 권한을 줄지, 그 사람이 무엇을 볼 수 있는지는 공식 공유 안내와 실제 공유 화면에서 확인합니다.

작은 도구를 공개할 때는 사용 목적, 입력 예시, 계산 규칙, 알려진 한계를 짧게 붙이면 독자가 판단하기 쉽습니다. “정답을 알려 주는 학습 도구”보다 “입력한 비중에 따라 공부 시간을 나누는 계획 도구”가 실제 기능을 더 정확히 설명합니다. 공유 후에도 수정할 내용과 확인한 날짜를 기록해 두세요.

6. 문서와 작은 도구 중 무엇을 만들지 선택하기

Artifacts로 같은 내용을 여러 형태로 만들 수 있어도 목적에 맞는 결과를 고르는 편이 좋습니다. 읽는 사람이 정해진 설명을 보는 일인지, 숫자를 바꾸며 결과를 비교하는 일인지 먼저 나누세요. 정해진 공부 계획을 전달할 목적이면 문서가 간단하고, 입력에 따라 계획을 바꿀 목적이면 작은 도구를 검토할 수 있습니다.

목적	요청할 결과	완료를 판단할 기준
사용 순서를 전달	짧은 안내 문서	필요한 단계와 예외가 들어 있음
수치에 따라 계획 변경	입력과 결과가 있는 도구	계산 규칙과 오류 처리가 맞음
발표에서 설명	내용을 나눈 발표 자료	한 화면에 읽을 분량이 적절함
배치·색상 검토	디자인 초안	대상 화면 크기와 문구가 맞음

공식 문서는 문서·발표·디자인용 템플릿과 계정별 제공 조건을 구분합니다. Artifacts를 사용하려면 관련 코드 실행·파일 생성 기능 조건도 살펴봐야 합니다. 이 내용은 앞의 공식 링크를 기준으로 확인할 수 있으며, 특정 계정에서 모든 템플릿을 쓸 수 있다는 뜻은 아닙니다.

화면이 예전 설명과 다르다면 결과물의 생성 시점과 종류를 보세요. 현재 공식 문서는 과거에 만든 legacy artifacts와 새 결과물의 동작을 구분합니다. 예전 결과물의 내보내기·공유 버튼을 새 작업에서도 그대로 기대하기보다, 지금 열어 둔 결과물의 공식 안내를 적용해야 합니다.

7. 공부 도구 명세를 조금 더 구체적으로 작성하기

앞의 도구에 실제로 사용할 계획을 담으려면 시간의 단위, 비어 있는 값 처리, 소수점 표시를 정해야 합니다. 아래는 이 글에서 만든 상세 명세입니다. 복사한 뒤 과목과 입력 범위를 자기 상황에 맞게 바꾸어 사용할 수 있습니다.

공부 시간 배분 도구를 만들어 주세요.
목적: 오늘 사용할 시간을 과목별로 나누어 보는 계획용 초안.
사용자: 한국어를 읽는 초보자. 설명은 화면에 짧게 표시.
입력:
- 전체 공부 시간: 분 단위의 양의 정수.
- 세 과목의 비중: 각각 0~100의 정수.
계산:
- 비중 합계가 100일 때만 계산.
- 배정 시간 = 전체 시간 × 해당 비중 ÷ 100.
- 내부 계산에는 표시용 반올림 전의 값을 유지.
- 소수점 한 자리 반올림은 화면 표시 단계에서만 적용.
- 전체 합계는 반올림 전 과목별 계산값을 합한 뒤 표시.
- 반올림한 표시값을 다음 계산이나 합계 계산에 다시 사용하지 않음.
- 표시된 과목별 시간의 합계와 전체 시간이 다르면 표시 반올림 차이를 안내.
- 정수로 바꾸는 기능은 이번에는 만들지 않음.
처리:
- 빈칸이나 잘못된 값은 입력 위치별로 이유 표시.
- 오류가 있는 동안 이전 계산 결과는 '이전 결과'라고 표시.
- 과목 이름과 전체 합계를 결과에 같이 표시.
범위:
- 로그인·외부 연결·데이터 저장은 이번 요청에 포함하지 않음.
- 실제 학습 효과나 추천 비중을 보장하지 않음.
먼저 구현할 동작 목록과 아래 사례의 기대값을 정리해 주세요.
내가 그 규칙을 읽은 뒤 화면 초안을 만들어 주세요.

정수 반올림 규칙을 아직 정하지 않았다면 첫 버전에서는 소수점 한 자리 결과를 보여 주는 선택도 가능합니다. 이 경우에도 각 행을 반올림해 표시하면 행별 표시값의 합계가 전체 시간과 다를 수 있습니다. 내부 계산값을 유지하고 표시 차이를 안내하는 규칙을 명세에 넣으세요. 정수 표시가 꼭 필요하다면 남는 분을 어떤 순서로 배정할지도 별도로 정해야 합니다.

가상 확인 예시로 전체 1분에 비중 33·33·34를 적용하면 반올림 전 값은 0.33·0.33·0.34분입니다. 소수점 한 자리로 각각 표시하면 0.3·0.3·0.3분이 되어 표시값의 합은 0.9분이지만, 반올림 전 합계는 1분입니다. 화면에는 전체 1.0분과 함께 “표시 반올림으로 과목별 표시값의 합계가 전체보다 0.1분 적게 보입니다”처럼 설명할 수 있습니다. 이는 작성자가 계산한 검토용 예시이며 실제 Artifact 실행 결과가 아닙니다.

8. 가상 입력표로 계산과 오류를 검토하기

아래 값은 작성자가 위 명세를 기준으로 계산한 기대 결과입니다. Claude가 만든 화면에서 얻은 테스트 결과가 아닙니다. 실제 결과물은 이 표와 비교해서 동작을 살펴보세요.

입력	명세에 따른 기대 결과	찾을 오류
120분 / 25·25·50	30.0·30.0·60.0분	과목 순서가 바뀌지 않았는지
45분 / 20·30·50	9.0·13.5·22.5분	소수점 값의 누락 여부
100분 / 0·40·60	0.0·40.0·60.0분	0% 과목이 잘못 오류가 되는지
120분 / 25·25·40	합계 90이라 계산 중단	자동으로 비중을 바꾸는지
전체 시간 빈칸	시간 입력 안내	빈칸을 0으로 계산하는지

정상 입력만 넣으면 화면이 잘 만들어졌다고 느끼기 쉽습니다. 값을 지우거나 비중 합계를 바꾸고 계산 버튼을 누르는 과정을 살펴보세요. 특히 새 입력에 오류가 났는데 예전 결과가 현재 결과처럼 남으면 사용자가 잘못 읽을 수 있습니다. 그 경우 표시 규칙을 고쳐 달라고 요청해야 합니다.

전체 시간을 지웠을 때 기존 120분 결과가 그대로 보입니다.
기존 결과는 유지하되 '이전 결과: 현재 입력은 미완성'으로 표시하세요.
현재 입력이 유효할 때 계산한 결과와 구분해 주세요.
계산식과 과목 순서는 바꾸지 마세요.
수정 후 빈칸 → 정상 값 → 비중 합계 오류 순서로
살펴볼 항목을 목록으로 알려 주세요.

실제 오류를 보고할 때는 무엇을 입력했고 어떤 화면을 보았는지 적어야 합니다. 위 문구는 오류 수정 요청을 설명하는 가상 예시입니다. 아직 관찰하지 않은 현상을 이미 발생한 오류처럼 보내지 말고 “이 조건을 처리하는지 확인해 줘”로 바꾸어 요청하세요.

9. 공유할 버전과 작업 중인 초안을 구분하기

1. 명세와 결과가 같은지 정상·오류 입력을 대조합니다.
2. 가상 이름과 자료, 내부 메모를 화면과 설명에서 찾습니다.
3. 사용 목적, 입력 단위, 계산 규칙을 짧게 안내합니다.
4. 현재 결과물에서 제공하는 내보내기 형식이나 공유 방법을 고릅니다.
5. 공유 범위와 접근 권한을 읽고, 수신자가 열 수 있는 환경인지 따로 확인합니다.

도구를 설명하는 문서도 함께 만들 수 있습니다. “입력 예시 하나, 잘못된 입력의 처리, 저장 여부, 알려진 한계를 4문단으로 정리해 줘”라고 요청하면 전달 자료의 초안을 받을 수 있습니다. 저장을 구현하지 않았다면 저장된다고 적지 말고, 구현한 경우에도 실제 저장과 다시 열기 동작을 살펴보아야 합니다.

기획과 사용에서 자주 나오는 추가 질문

출력 형식을 먼저 지정해야 하나요? 다른 앱에서 수정할 목적이면 필요한 형식을 먼저 적고 실제 제공 여부를 비교하세요. 색상부터 고쳐도 되나요? 색상은 자유롭게 바꾸되 오류 표시와 계산 기준이 동시에 바뀌지 않도록 유지 조건을 붙이세요. 앱 연결이 필요한가요? 정해진 입력만으로 계산하는 도구는 외부 연결 없이 기획할 수 있습니다. 연결이 필요한 작업은 대상 자료와 읽기·쓰기 목적을 별도로 정하세요.

자주 묻는 질문과 실수 해결

Artifacts가 보이지 않으면요? 계정에서 기능을 사용할 조건과 설정을 공식 문서로 확인하고, 필요한 결과물 종류를 질문에 직접 적어 보세요. 오류가 나타나면요? 오류 문구와 발생 입력, 기대한 결과를 함께 전달합니다. 공유하면 완성된 서비스인가요? 실제 사용과 운영에 필요한 기능을 별도로 확인해야 합니다. 초안 생성만으로 검토가 끝나는 것은 아닙니다.

공식 출처와 확인일

• What are artifacts and how do I use them?
• Share artifacts

공식 문서 확인일: 2026년 10월 3일. 화면과 제공 조건은 이후 바뀔 수 있습니다.