소개: 코드는 당신의 느낌에 관심이 없습니다
대규모 언어 모델과 코드에 대한 사실은 다음과 같습니다. 이들은 놀라울 정도로 자신감이 넘치고 프로그램 컴파일 여부에 대해서는 완전히 무관심합니다. Claude Haiku 4.5는 여러분의 문제를 해결하는 Python 스크립트를 기꺼이 작성해 줄 뿐만 아니라, 재미로 두 가지 문제를 더 만들어 낼 것입니다. 중요한 유일한 비결은 느낌이 들어갈 여지를 없애고 진실이 최대한 드러나도록 정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법을 배우는 것입니다. 코드처럼 들리는 산문을 원하는 것이 아닙니다. 코드처럼 작동하는 코드를 원합니다. 여기에는 차이가 있습니다.
사람들은 프롬프트를 신비로운 주문처럼 취급합니다. 올바른 단어를 말하면 완벽한 앱을 얻을 수 있다고 생각합니다. 이는 사고방식입니다. 코드는 계약입니다. Claude Haiku로부터 정확성을 얻고 싶다면 계약을 작성해야 합니다. "웹 앱 구축"은 계약이 아닙니다. "JSON을 허용하고, Pydantic v2로 스키마를 검증하며, 특정 페이로드 형식으로 스키마 오류 시 422를 반환하는 Python 3.12의 FastAPI 엔드포인트를 생성합니다."는 계약입니다. 이것이 바로 정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법입니다. 계약을 명확히 하는 것입니다.
이 문서의 내용 (및 내용이 아닌 것)
- Claude Haiku 4.5로부터 신뢰할 수 있고 테스트 가능한 코드를 얻기 위한 사용법 가이드입니다.
- "AI가 개발자를 대체한다"는 설교가 아닙니다. 도구는 사고를 대체하지 않습니다.
- 실용적인 프롬프트, 구조 및 안전 장치에 중점을 둡니다. 즉, 마법이 작동하도록 하는 지루한 부분에 집중합니다.
실행되는 코드를 원한다면 Claude에게 "실행"에 대한 실질적인 정의를 제공해야 합니다. 정확한 코드 생성을 원한다면 정확성을 명확하고 테스트 가능한 용어로 정의해야 합니다. 이것이 전부입니다.
시인이 아닌 변호사처럼 정확성을 정의하십시오
"정확한" 코드는 "그럴듯해 보이는" 코드가 아닙니다. 정확성은 다음과 같습니다.
- 구문 유효성: 컴파일되거나 인터프리터에서 실행됩니다.
- 의미론적 충실도: 사양에 명시된 대로 작동합니다.
- 결정적 동작: 정의된 오류 범위 내에서 동일한 입력, 동일한 출력.
- 버전 정확성: 올바른 SDK, API 버전 및 언어 기능을 사용합니다.
Claude는 여러분이 요청하는 것을 제공할 것입니다. "목록을 정렬하는 함수"를 요청하면 아마도 하나를 얻을 것입니다. "O(1)의 추가 공간으로 Timsort 의미 체계를 사용하여 안정적인 제자리 정렬"을 요청하면 다른 약속이 됩니다. "정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법"은 이러한 약속을 프롬프트에 작성하는 것으로 시작합니다.
최소 실행 가능 프롬프트, 업그레이드됨
나쁨: "작업을 위한 Node API를 작성하십시오."
더 나음: "필드 {title: string, dueDate: ISO 8601}을 검증하고 생성된 객체와 함께 201을, 오류 세부 정보와 함께 400을 응답하는 /tasks POST 경로가 있는 Node 20 Express 4 API를 작성하십시오."
정확함: "단일 /tasks POST 엔드포인트가 있는 Node 20 Express 4 서버를 생성합니다. 요구 사항: 1) [email protected]으로 본문 유효성 검사; 2) 필드: title (비어 있지 않은 문자열, 최대 140자), dueDate (ISO 8601 미래 날짜); 3) 성공 시: {id: ULID, title, dueDate}와 함께 201; 4) 유효하지 않은 경우: {error: 'VALIDATION', details: array}와 함께 400; 5) 데이터베이스 없음; 인메모리 Map; 6) 유효, 유효하지 않음 (빈 제목, 과거 날짜)을 다루는 Jest 29 테스트 파일 포함; 7) 테스트 및 개발을 위한 npm 스크립트 제공; 8) ESM 사용; 9) 불필요한 설명을 포함하지 마십시오." 모양을 확인하십시오: 언어 버전, 라이브러리, 제약 조건, 출력, 오류, 테스트, 심지어 패키지 구조까지. 모호성을 제거했습니다. Claude의 임무는 요구 사항이 아닌 코드를 채우는 것입니다.
발판 패턴: 시스템, 사양, 테스트, 그런 다음 코드
Claude Haiku 4.5로부터 정확한 코드 생성을 원한다면 활주로를 제공해야 합니다.
- 당신: "당신은 Node 20을 위한 프로덕션 품질의 TypeScript를 작성하고 있습니다. 파일 이름이 있는 코드 블록만 출력하고 다른 것은 출력하지 마십시오."
- 이유: 당신은 톤과 출력 형식을 제어합니다. 운에 맡기지 마십시오.
- 언어 버전, 패키지 선택, 오류 의미 체계, I/O 형식, 성능 제한 및 보안 제약 조건을 포함합니다.
- Claude에게 단위 테스트를 먼저 작성하도록 지시하십시오. 테스트는 형용사보다 "정확한" 것을 더 잘 정의합니다. 코드 한 줄이 테스트에 도움이 되지 않으면 장식일 뿐입니다.
- 테스트 후에만. 네, 기본적으로 TDD이지만, 상용구 작성에 결코 지루해하지 않는 로봇이 있습니다.
- "테스트가 실패하거나 가져오기가 일치하지 않으면 실패한 부분만 업데이트하십시오. 전체 프로젝트를 다시 작성하지 마십시오."
Claude는 컨텍스트와 레일이 있을 때 잘 작동합니다. 레일을 제공하십시오.
버전 고정은 선택 사항이 아닙니다
Claude의 훈련 데이터는 오래된 문서와 새로운 문서로 가득 차 있습니다. 이는 상충되는 조언을 많이 보았다는 완곡한 표현입니다. "React Router 사용"은 모호합니다. "데이터 라우터가 있는 [email protected] 사용"은 방향입니다. 기본값을 신뢰하지 마십시오. - 언어: Python 3.12, Node 20, Go 1.22, Java 21 (실제로 실행하는 버전)에 고정하십시오.
- 프레임워크: 정확한 주요 버전과 주요 변경 플래그를 지정하십시오.
- 클라우드 SDK: 버전 고정; aws-sdk v2와 v3는 중요합니다.
- 린터/포맷터: "스타일 핑퐁" 재작성을 방지하기 위해 규칙을 지정하십시오.
고정하지 않으면 5년 동안의 블로그 게시물에서 가장 인기 있는 곡을 얻을 수 있습니다. 정확한 코드 생성은 향수에 알레르기가 있습니다.
스키마 우선, 항상
"사용자 프로필" 구조를 요청하지 마십시오. 프롬프트에서 스키마를 정의하고 유효성 검사를 요구하십시오.
- JS/TS의 JSON 스키마 또는 Zod/Yup 유형
그런 다음 Claude가 API 입력, 데이터베이스 쓰기 및 메시지 큐와 같은 경계에서 스키마를 적용하도록 하십시오. 명시적 오류 페이로드 및 코드를 요청하십시오. 정확성은 스키마를 좋아합니다. 모호성은 그렇지 않습니다.
관찰 가능하게 만들거나 실제인 척하지 마십시오
Claude에게 로깅, 메트릭 및 추적을 필요한 곳에 추가하도록 지시하십시오. 그리고 필요하지 않은 곳에서는 조용히 유지하도록 하십시오. 좋은 프롬프트에는 다음이 포함됩니다.
- 로깅 정책: 수준, PII 수정, 구조 (JSON 로그 부탁드립니다)
- 상태 엔드포인트: 종속성이 작동 중임을 증명하는 /healthz
Claude는 여러분이 요청하는 것을 추가할 것입니다. 요청하지 않으면 운이 좋으면 print 문을 얻을 수 있습니다.
테스트 우선 프롬프트가 "그냥 믿어주세요"보다 낫습니다
정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 좋은 방법은 테스트를 진실의 원천으로 만드는 것입니다. 예:
"다음 기능을 수행하는 normalize_email(s) 함수에 대한 pytest 테스트를 작성하십시오.
- gmail.com에 대해서만 로컬 부분의 점을 제거;
- gmail.com에 대해서만 하위 주소(+tag)를 제거;
- 유니코드 도메인 punycode를 그대로 유지하십시오. 가장자리 케이스를 다루십시오. 테스트를 작성한 후 테스트를 통과하도록 함수를 구현하십시오."
Claude는 설명한 테스트를 만족하도록 강요받을 때 종종 더 나은 코드를 작성합니다. 그렇지 않으면 분위기 논쟁이 아닌 구체적인 실패가 발생합니다.
구성에 의한 환각 없음
환각을 제거할 수는 없지만 울타리를 칠 수는 있습니다.
- 소스가 존재하는 경우에만 인용 또는 소스 URL을 요청하십시오. SDK 메서드의 경우 문서 링크를 요구하고 코드가 해당 문서와 일치하도록 요구하십시오.
- 개인 API의 경우 프롬프트에 사양을 붙여넣으십시오. Claude가 내부 엔드포인트를 알 것이라고 기대하지 마십시오.
- 혼란스러운 API가 있는 라이브러리의 경우 공식 문서에서 예제 스니펫을 포함하고 Claude에게 이를 준수하도록 지시하십시오.
정확한 코드는 대부분 정확한 참조입니다. Claude에게 참조를 제공하십시오.
스타일 가이드: 가장 섹시하지 않고 가장 유용한 것
Claude는 추론하는 스타일로 코드를 작성합니다. 이는 변경을 위한 레시피입니다. 스타일 가이드를 붙여넣으십시오. 지정하십시오.
- 포맷팅 (Prettier, Black, gofmt 기본값)
또한 명확하지 않은 선택에 대한 짧은 근거 설명을 요구하십시오. 미래의 당신은 감사할 것이고 현재의 Claude는 더 적은 "수정" PR을 생성할 것입니다.
긴 프롬프트, 짧은 출력
정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법에 대해 생각하는 또 다른 방법은 출력에 단어가 아닌 프롬프트에 단어를 사용하는 것입니다. 당신은 다음을 원합니다.
설명을 억제하고 파일 이름과 짧은 README가 있는 코드 블록만 반환하도록 지시하십시오. 주석을 원하면 별도의 실행에서 요청하십시오. 산문과 코드를 섞으면 단안경과 중절모를 쓴 버그가 몰래 들어오는 방법입니다.
개선: 실제로 작동하는 빡빡한 루프
신뢰할 수 있는 코드로 가는 가장 빠른 경로는 "처음 시도에 올바르게 만드는 것"이 아닙니다. 짧고 수정적인 루프입니다.
- 로컬에서 실행하십시오. 실패한 테스트 출력과 컴파일러 오류를 Claude에 그대로 다시 붙여넣으십시오.
- 지시하십시오: "최소한의 필요한 줄만 수정하십시오. 실패한 테스트에 필요한 경우가 아니면 함수 서명을 변경하지 마십시오."
Claude는 정확히 무엇이 고장났는지 알려주면 diff를 적용하는 데 탁월합니다. 실패 로그를 바꿔 말하지 마십시오. 붙여넣으십시오. 로그가 진실입니다.
보안은 기능이지 사후 고려 사항이 아닙니다
모델은 공개 코드 (좋은, 나쁜, 저주받은)로 훈련되었기 때문에 보안을 최우선 요구 사항으로 만들고 싶을 것입니다.
- eval, shell=True 및 문자열로 입력된 SQL을 명시적으로 허용하지 마십시오.
- 매개변수화된 쿼리, CSRF 보호 및 속도 제한을 요구하십시오.
- 환경 변수 또는 보안 관리자를 통해 비밀 처리를 요구하십시오.
기본적으로 안전한 프롬프트는 더 안전한 코드를 생성합니다. "나중에 패치하겠습니다" 프롬프트는 헤드라인을 생성합니다.
성능: "빠름"이 무엇을 의미하는지 말하십시오
"빠르게 만드십시오"는 "무엇이든 하십시오"로 해석됩니다. 대신 메트릭을 지정하십시오.
- 대기 시간 목표 (인메모리의 경우 p95 < 50ms, DB 작업의 경우 p95 < 300ms)
- 시간 복잡도 (O(n^2)가 아닌 O(n log n)이어야 함)
Claude는 설정한 예산에 맞는 알고리즘을 선택합니다. 예산을 제공하십시오.
설명서: 낯선 사람을 온보딩하기에 충분함
Claude에게 다음을 포함하는 README를 요청하십시오.
- 테스트, 린트, 타입 검사, 실행을 위한 명령
"정확한 코드"에는 정확한 문서가 포함됩니다. 이것들은 결과물의 일부입니다.
훔칠 수 있는 구체적인 프롬프트 템플릿
템플릿: 백엔드 엔드포인트
시스템: 당신은 꼼꼼한 Python 3.12 엔지니어입니다. 파일 이름이 있는 코드 블록만 출력하십시오.
사용자:
- POST /convert 엔드포인트가 있는 FastAPI 0.111 앱을 빌드하십시오.
- 요청: {amount: Decimal as string, from: 'USD'|'EUR', to: same}.
- pydantic v2로 유효성 검사하십시오. 스키마 오류 시 422 모양을 반환하십시오.
- 고정된 비율 {USD:1, EUR:1.1}로 순수 함수 convert(amount, from, to)를 사용하십시오.
- {amount: string, currency: string}와 함께 200을 반환하십시오.
- 유효, 유효하지 않음 (잘못된 십진수, 알 수 없는 코드) 및 가장자리 (0)를 다루는 pytest 테스트를 포함하십시오.
- 고정된 종속성이 있는 pyproject.toml을 제공하십시오. ruff 및 mypy 구성을 포함하십시오.
템플릿: CLI 유틸리티
시스템: Go 1.22를 작성하고 있습니다. 파일 이름이 있는 코드 블록만 출력하십시오.
사용자:
- stdin을 읽고 URL 안전 슬러그를 인쇄하는 slugify라는 CLI를 만드십시오.
- 규칙: 소문자, ASCII 전용, 하이픈 구분 기호, 공백 축소, 구두점 제거.
- 테이블 테스트와 함께 main.go 및 slugify_test.go를 제공하십시오.
- 테스트 및 빌드 대상이 있는 Makefile을 포함하십시오.
템플릿: 프런트엔드 구성 요소
시스템: 당신은 React 18 + TypeScript를 대상으로 하는 실용적인 React 엔지니어입니다.
사용자:
- <DebouncedInput> 구성 요소를 구현하십시오.
- props: value: string, onChange(value): void, delay=300.
- useRef/useEffect를 사용하십시오. 타사 훅은 사용하지 마십시오.
- 가짜 타이머로 vitest 테스트를 포함하십시오.
- 최소한의 Storybook 스토리를 제공하십시오.
이러한 템플릿은 버전을 고정하고, 동작을 정의하고, 테스트를 요구하여 정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법을 보여줍니다.
영리해지기를 거부하기: 언제 "최적화하지 마십시오"라고 말할까
조기 마이크로 최적화를 원하지 않는 경우 (그리고 원하지 않음) 그렇게 말하십시오.
- "테스트에서 요구하지 않는 한 영리함보다 가독성을 선호하십시오. 비트 조작은 없습니다."
- "메타 프로그래밍은 없습니다. 명시적 > 암시적."
Claude는 감동시키는 것을 좋아합니다. 그러지 못하게 하십시오. 테스트를 통과하고 읽기 쉽도록 만드십시오. 그것만으로도 충분히 인상적입니다.
사람들이 생산성 의식처럼 임의의 채팅 탭에서 프롬프트를 저글링하는 것을 보았습니다. 코드 컨텍스트를 이해하는 작업 공간을 사용하십시오. 예를 들어 Sider.AI는 사양, 코드, diff 및 테스트 로그를 항상 볼 수 있도록 구축되어 "오류를 붙여넣고 줄을 수정" 루프가 실제로 빡빡합니다. 마법이 아니라 플롯을 잃지 않도록 하는 지루한 발판입니다. 도구가 계약, 테스트 및 코드를 동일한 대화에 유지하면 (종이를 뿌리며 괴롭히지 않고) 사용하십시오. Sider는 그렇게 합니다. 오라클이 아닌 팀 동료로서 Claude로 디버깅하는 방법
- 실패한 테스트 출력을 있는 그대로 정확하게 붙여넣으십시오. 요약하지 마십시오.
- diff를 요청하십시오: "파일 X에 대해서만 통합 diff로 응답하십시오."
- 런타임 버그의 경우 가장 작은 재현 가능한 스니펫을 추가하고 설명과 패치를 요구하십시오.
- 라이브러리 오류의 경우 적용된다고 생각하는 문서 발췌문을 붙여넣고 다음을 요청하십시오. "이것이 버전 X에 대한 올바른 API입니까? 그렇지 않은 경우 코드를 업데이트하고 올바른 발췌문을 인용하십시오."
목표는 Claude가 증거로 논쟁하도록 만드는 것입니다. 당신은 증거를 가져옵니다.
함정 퍼레이드 (및 피하는 방법)
- "최신" API 함정: "최신"이라고 말하지 마십시오. "버전 X.Y"라고 말하고 고수하십시오.
- 빈 테스트 파일: 테스트를 요구하지 않으면 얻을 수 없습니다.
- 단발성 오류: 두세 번의 짧은 개선을 계획하십시오. 하나의 부풀려진 프롬프트보다 빠릅니다.
- 모호한 오류 정책: 상태 코드와 페이로드를 정의하십시오. "오류를 반환"은 아무 의미가 없습니다.
- 소유되지 않은 종속성: 코드가 제어할 수 없는 서비스에 의존하는 경우 스텁하십시오. 가짜를 요청하십시오.
프롬프트 체크리스트 (모니터 옆에 테이프로 붙여 놓으십시오)
- 제한된 출력 형식 (파일 이름, 코드 블록, diff)
이 열 가지를 모두 충족하면 Claude Haiku 4.5는 일반적으로 햇빛에 살아남는 정확한 코드 생성을 생성합니다.
작업 예제: 모호함에서 검증됨으로
모호한 프롬프트: "CSV를 안전하게 파싱하는 함수를 작성하십시오."
결과: 아마도 괜찮을 것이지만, 틀릴 수도 있고, 확실히 테스트되지 않았을 것입니다.
정확한 프롬프트:
"Python 3.12를 작성하고 있습니다. 파일 이름이 있는 코드 블록만 출력하십시오.
csvsafe/init.py 및 csvsafe/reader.py를 read_rows(path: Path) -> list[dict[str,str]] 함수와 함께 만드십시오. 요구 사항: newline='' 및 encoding='utf-8'과 함께 csv.DictReader를 사용하십시오. null 바이트를 허용하지 마십시오. 10MB보다 큰 파일을 거부하십시오. 열을 100개로 제한하십시오. BOM을 제거하십시오. 빈 셀을 빈 문자열로 처리하십시오. {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS} 메시지 코드가 있는 ValueError를 발생시키십시오. happy path, null byte, 11MB 파일, 101 열 및 BOM 처리를 다루는 pytest와 함께 tests/test_reader.py에 테스트를 포함하십시오. 고정된 종속성 및 검은색 구성이 있는 pyproject.toml을 제공하십시오."
코드, 테스트 및 가장자리 처리를 얻을 수 있습니다. 그런 다음 테스트를 실행하고, 실패를 붙여넣고, 최소한의 diff로 반복합니다. 이것이 실제적인 정확한 코드 생성입니다.
"창의성" 및 기타 마케팅 단어에 대해
저는 "창의적인" 코드가 필요하지 않습니다. 저는 올바른 코드가 필요합니다. 고양이 이름을 짓기 위해 창의력을 발휘하십시오. Claude에 프롬프트를 작성할 때 창의성은 견고한 제약 조건의 자연스러운 부산물입니다. 올바른 테스트와 명확한 사양은 우아한 솔루션을 생성합니다. 잘못된 프롬프트는 "이모티콘으로 기본 64를 재창조"합니다. 유혹하지 마십시오.
비밀이 아닌 비밀
정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법은 지루합니다. 필요한 것을 적고, 버전을 고정하고, 스키마를 정의하고, 테스트를 요구하고, 실제 실패로 반복하십시오. 그게 전부입니다. 신비주의는 없습니다. 매우 빠르게 입력할 수 있고 거의 동일한 15개의 테스트 케이스를 작성하는 것을 꺼리지 않는 모델을 사용하는 엔지니어링 규율일 뿐입니다.
그리고 그것이 반전입니다. 정확성은 매력적이지 않습니다. 작동하는 프롬프트는 TSA 체크리스트처럼 보입니다. 배송되는 코드는 신경 쓰는 사람이 작성한 것처럼 보입니다. 명확한 요구 사항에서 번성하고 모호한 방향에서 시드는 주니어 엔지니어처럼 모델을 취급하면 둘 다 얻을 수 있습니다. 계약을 제공하십시오. 테스트를 통과하도록 하십시오. 그런 다음 도구에 주는 종류의 신뢰 (예언자가 아닌)로 신뢰할 수 있습니다.
결론: 마법은 줄이고 보증은 늘리고
마법을 원한다면 마술 쇼에 가십시오. 컴파일되고 작동하는 소프트웨어를 원한다면 보증처럼 작동하는 프롬프트를 작성하십시오. 정확한 코드 생성을 위해 Claude Haiku 4.5에 프롬프트를 작성하는 방법은 화려한 문구 또는 비밀 키워드에 관한 것이 아닙니다. 제약 조건, 테스트, 버전 및 피드백 루프에 관한 것입니다. 이 네 가지를 수행하면 실행되는 코드를 얻을 수 있습니다. 건너뛰면 아름답게 포맷된 소설을 얻을 수 있습니다.
코드는 당신의 느낌에 신경 쓰지 않습니다. 다행히 테스트도 마찬가지입니다.
FAQ
Q1: Claude Haiku 4.5를 사용하여 정확한 코드 생성을 유도하는 가장 간단한 방법은 무엇인가요?
계약처럼 취급하세요. 버전 고정, 스키마 정의, 오류 형식 지정, 그리고 테스트를 먼저 요구하세요. 제약 조건이 명확할수록 코드 정확도는 높아집니다.
Q2: Claude가 코드를 작성할 때 환각 현상을 줄이려면 어떻게 해야 하나요?
신뢰할 수 있는 문서나 사양을 붙여넣고 해당 API를 정확히 준수하도록 요구하세요. 비공개 엔드포인트의 경우 자체 사양을 포함하세요. 추측에 의존하지 마세요.
Q3: Claude에게 테스트를 요청해야 하나요, 아니면 직접 작성해야 하나요?
Claude에게 먼저 테스트 생성을 요청한 다음, 해당 테스트를 충족하는 코드를 구현하세요. 테스트는 형용사보다 정확성을 더 잘 정의하고 모델이 솔직하게 유지되도록 합니다.
Q4: 프롬프트에서 버전 고정은 얼마나 구체적이어야 하나요?
매우 구체적이어야 합니다. 언어 런타임, 프레임워크 주요/부 버전, SDK 버전 등을 명시하세요. "최신" 버전은 충돌하는 패턴을 유발하며, 정확성은 안정적인 타겟에 따라 달라집니다.
Q5: 정확한 코드를 위한 프롬프트에 Sider.AI는 어떻게 적용되나요?
Sider.AI를 사용하여 사양, 코드, 차이점 및 테스트 로그를 하나의 루프에 보관하세요. 마법을 부리는 것은 아니지만, Claude의 수정 사항이 실제 실패를 추적할 수 있도록 컨텍스트를 보존합니다. 
