클로드 코드로 첫 코드 작성하고 실행하기
“설치도 했고 프로젝트 폴더에서 실행도 해봤는데… 이제 진짜 코드는 어떻게 만들죠?” 앞선 편들을 잘 따라오셨다면 지금쯤 이런 궁금증이 생기실 거예요. 이번 편에서는 클로드 코드 예제를 직접 따라 하면서, 자연어로 요청만 하면 AI가 실제 코드를 작성하고 실행까지 해주는 과정을 함께 실습해 보겠습니다. 프로그래밍 문법을 몰라도 괜찮습니다. 우리가 할 일은 “무엇을 만들고 싶은지” 한국어로 설명하는 것뿐이니까요.
클로드 코드 코딩, 어떻게 작동하나요?
먼저 개념부터 짚고 갈게요.
클로드 코드(Claude Code)란, 터미널에서 자연어 명령을 입력하면 AI가 코드를 작성·수정하고, 파일을 읽고, 명령어까지 실행해 주는 앤트로픽(Anthropic)의 공식 AI 코딩 도구입니다.
기존 코딩은 사람이 문법을 외워서 한 줄 한 줄 타이핑했지만, AI 코드 생성 방식은 다릅니다. 흐름을 비교하면 이렇습니다.
| 구분 | 기존 방식 | 클로드 코드 방식 |
|---|---|---|
| 입력 | 프로그래밍 문법 | 자연어(한국어) 설명 |
| 코드 작성 | 사람이 직접 | AI가 자동 생성 |
| 파일 저장 | 수동으로 저장 | AI가 파일까지 생성 |
| 실행 | 직접 명령어 입력 | AI에게 실행 요청 가능 |
즉, 우리는 “기획자”처럼 원하는 걸 말하고, 클로드는 “개발자”처럼 만들어 주는 구조라고 생각하시면 편합니다.
클로드 코드 실습: 첫 코드 만들기 3단계
이제 실제로 만들어 볼까요? 터미널에서 프로젝트 폴더에 들어가 claude 명령으로 클로드 코드를 실행한 상태라고 가정하겠습니다.
1단계 — 원하는 기능을 자연어로 설명하기
프롬프트 입력창에 이렇게 적어보세요.
간단한 파이썬 프로그램을 만들어줘. 실행하면 "안녕하세요!"라고
출력하고, 오늘 날짜도 함께 보여주는 프로그램이야.
포인트는 구체적으로, 하지만 문법 걱정 없이 설명하는 것입니다. “무엇을”, “어떻게 동작하면 좋겠는지”만 알려주면 됩니다.
2단계 — 클로드가 코드를 작성하고 파일 생성
요청을 보내면 클로드는 코드를 제안하고, hello.py 같은 파일을 만들겠다고 알려줍니다. 이때 클로드는 파일을 만들거나 수정하기 전에 어떤 작업을 할지 먼저 보여주고 승인을 요청하는 경우가 많습니다. 내용을 확인한 뒤 허용하면, 실제 파일이 폴더에 생성됩니다.
- ✅ 제안된 코드 내용을 눈으로 확인
- ✅ 이상 없으면 Yes(허용) 선택
- ✅ 폴더에 새 파일이 생성된 것 확인
3단계 — 코드 실행하고 결과 확인
파일이 만들어졌다면 이렇게 이어서 요청해 보세요.
방금 만든 프로그램을 실행해서 결과를 보여줘.
그러면 클로드가 python hello.py를 실행하고, 터미널에 출력 결과를 그대로 보여줍니다. “안녕하세요!”와 오늘 날짜가 찍혀 나온다면, 축하합니다. 여러분의 첫 코드가 완성되고 실행된 것입니다! 🎉
결과가 이상할 때는 어떻게 하나요?
처음부터 원하는 대로 안 나올 수도 있어요. 그럴 땐 대화를 이어가며 고치면 됩니다. 이게 클로드 코드 코딩의 가장 큰 장점이에요.
- 출력을 바꾸고 싶을 때: “인사말을 ‘반갑습니다!’로 바꿔줘”
- 기능을 추가하고 싶을 때: “날짜에 요일도 같이 표시해줘”
- 에러가 났을 때: 에러 메시지를 그대로 붙여넣고 “이 오류 고쳐줘”
한 번에 완벽하게 만들기보다, 작게 요청하고 → 결과 확인 → 다시 요청하는 반복이 핵심입니다. 이 짧은 순환이 바로 AI 코딩의 기본 워크플로우예요.
첫 실습을 위한 작은 팁
- 요청은 한 번에 하나의 목표로 나누면 결과가 정확해집니다.
- 파일을 생성·수정하는 요청은 승인 전에 내용을 꼭 확인하세요.
- 원하는 결과를 예시로 함께 적어주면(“이런 식으로 나오면 좋겠어”) 정확도가 올라갑니다.
- 잘 안 되면 좌절 말고 그냥 대화로 “다시 해줘”라고 말하세요.
자주 묻는 질문(FAQ)
Q1. 프로그래밍을 전혀 몰라도 코드를 만들 수 있나요?
네, 가능합니다. 클로드 코드는 자연어(한국어) 설명을 코드로 바꿔주기 때문에, 문법을 몰라도 “무엇을 만들고 싶은지”만 설명할 수 있으면 됩니다. 다만 결과를 이해하고 다듬는 과정을 반복하면서 자연스럽게 코딩 감각이 늘어납니다.
Q2. 클로드가 만든 코드를 제가 직접 실행해야 하나요?
꼭 그렇지는 않습니다. “실행해줘”라고 요청하면 클로드가 터미널에서 명령을 실행하고 결과를 보여줍니다. 물론 직접 터미널에 명령어를 입력해 실행할 수도 있습니다. 다만 파일 생성이나 명령 실행 전 승인 단계를 확인하는 습관을 들이는 것이 안전합니다.
Q3. 처음 요청에서 원하는 결과가 안 나오면 실패인가요?
전혀 아닙니다. 오히려 정상입니다. 결과를 보고 “이 부분을 이렇게 바꿔줘”라고 대화를 이어가며 완성하는 것이 클로드 코드의 정석 사용법입니다.
한 줄 요약: 클로드 코드는 “만들고 싶은 것을 한국어로 설명 → 코드 생성 승인 → 실행 요청”의 3단계만 익히면, 초보자도 오늘 바로 첫 코드를 완성하고 실행할 수 있습니다.