[Claude 입문] 4편 — 실전 프롬프트 따라하기 ② 개발/코딩 편

📌 이 글에서 다루는 것

코드 작성, 디버깅, 리뷰, 설명 요청 등 개발할 때 Claude를 쓰는 실전 프롬프트를 모았다. 비개발자도 간단한 자동화나 스크립트에 활용할 수 있다.

---

💡 코딩에서 Claude를 쓸 때 핵심 원칙

맥락을 많이 줄수록 코드 품질이 올라간다. 언어, 환경, 제약 조건, 원하는 결과를 같이 알려주자.

---

🛠️ 1. 코드 작성 요청

[언어]로 아래 기능을 구현해줘.

기능 : [구현할 내용]
조건 : [특별한 제약이나 요구사항]
사용 환경 : [Python 3.11 / Node.js 20 / 브라우저 등]

예시:

Python으로 아래 기능을 구현해줘.

기능 : CSV 파일을 읽어서 특정 컬럼 기준으로 중복을 제거하고 새 파일로 저장
조건 : pandas 없이 기본 라이브러리만 써줘
사용 환경 : Python 3.11

---

🐛 2. 디버깅 요청

아래 코드에서 에러가 나는데 원인이 뭔지, 어떻게 고치면 되는지 알려줘.

에러 메시지 :
[에러 메시지 붙여넣기]

코드 :
[코드 붙여넣기]

에러 메시지를 같이 붙여넣는 게 핵심이다. 메시지 없이 "왜 안 돼?"라고 하면 추측만 하게 된다.

---

🔍 3. 코드 리뷰 요청

아래 코드를 리뷰해줘.

중점적으로 봐줄 것 : [성능 / 가독성 / 보안 / 전반적인 개선점]
언어/프레임워크 : [Python / JavaScript / React 등]

[코드 붙여넣기]

예시:

아래 코드를 리뷰해줘.

중점적으로 봐줄 것 : 가독성과 불필요한 중복 제거
언어 : JavaScript

[코드 붙여넣기]

"시니어 개발자 입장에서 봐줘"를 추가하면 더 날카로운 리뷰가 나온다.

---

📖 4. 코드 설명 요청

아래 코드가 어떻게 동작하는지 설명해줘.
[초보자도 이해할 수 있게 / 핵심 로직 위주로 / 각 줄마다 주석 달아서]

[코드 붙여넣기]

오픈소스 코드나 동료 코드를 이해할 때 유용하다. "이 함수에서 왜 이렇게 했는지 이유도 추측해줘"를 붙이면 의도까지 분석해준다.

---

🔄 5. 코드 변환/리팩토링

아래 코드를 [다른 언어 / 더 간결하게 / 함수형으로 / 클래스 기반으로] 변환해줘.

[코드 붙여넣기]

자주 쓰는 변환 요청:

• 이 Python 코드를 JavaScript로 변환해줘
• 이 반복문을 list comprehension으로 바꿔줘
• 이 코드에서 중복되는 부분을 함수로 분리해줘
• async/await 패턴으로 바꿔줘

---

📝 6. 주석/문서 작성

아래 코드에 주석을 달아줘.
[한국어 / 영어]로, [간결하게 / 상세하게] 작성해줘.

[코드 붙여넣기]

또는:

아래 함수에 대한 docstring을 작성해줘.
파라미터 설명, 반환값 설명, 사용 예시를 포함해줘.

[함수 코드 붙여넣기]

---

🧪 7. 테스트 코드 작성

아래 함수에 대한 테스트 코드를 작성해줘.

테스트 프레임워크 : [pytest / Jest / JUnit 등]
포함할 케이스 : [정상 케이스, 엣지 케이스, 에러 케이스]

[함수 코드 붙여넣기]

"테스트 커버리지를 높이려면 어떤 케이스를 추가해야 할지도 알려줘"를 붙이면 테스트 전략까지 조언해준다.

---

⚠️ 코딩에서 주의할 점

Claude가 생성한 코드는 반드시 직접 실행해보고 검증해야 한다. 그럴듯해 보이지만 작동하지 않는 코드를 줄 때가 있다.

특히:

• 외부 라이브러리 버전에 따라 API가 다를 수 있다
• 보안에 민감한 코드(인증, 암호화 등)는 전문가 검토가 필요하다
• 대규모 코드베이스에 적용할 때는 테스트 먼저

---

✅ 이 편 핵심 요약

1. 언어, 환경, 제약 조건을 같이 알려줘야 좋은 코드가 나온다
2. 디버깅할 때는 에러 메시지를 반드시 같이 붙여넣어라
3. Claude 코드는 항상 직접 실행해서 검증해라

---

🔗 참고 링크

• 이전 편 — 3편 — 실전 프롬프트 따라하기 ① 일상/업무 편
• 다음 편 — 5편 — 무료로 얼마나 쓸 수 있나? 플랜별 정리
• Claude 공식 사이트 — https://claude.ai