이 블로그는 정적 사이트 생성기로 만들어져 있고, 빌드 스크립트는 파이썬입니다. 예전에는 스크립트를 고칠 때 클로드 대화창에 코드를 붙여 넣고, 답을 복사해서 다시 파일에 붙이는 일을 반복했습니다. 클로드 코드(Claude Code)를 쓰고 나서는 이 복사·붙여넣기가 사라졌습니다.
이번 글은 클로드 코드 카테고리의 첫 글로, 클로드 코드가 무엇이고 대화창 코딩과 어떻게 다른지 정리합니다.
클로드 코드는 무엇인가
클로드 코드는 Anthropic이 만든 에이전트형 코딩 도구입니다. 내 컴퓨터의 프로젝트 폴더에서 실행되어, 클로드가 직접 파일을 읽고, 고치고, 명령어를 실행합니다.
| 쓰는 곳 | 형태 |
|---|---|
| 터미널 | claude 명령으로 실행하는 대화형 CLI |
| IDE | VS Code, JetBrains 확장 |
| 데스크톱 앱 | Claude 앱의 Code 탭 |
| 웹·모바일 | claude.ai/code, 모바일 앱 (클라우드 세션·원격 연결) |
대화창 코딩과 무엇이 다른가
| 구분 | 대화창(claude.ai) | 클로드 코드 |
|---|---|---|
| 코드 전달 | 직접 복사해서 붙여 넣기 | 프로젝트 폴더를 직접 읽음 |
| 수정 반영 | 답을 복사해 파일에 붙이기 | 파일을 직접 수정 |
| 실행·테스트 | 내가 직접 실행 | 명령을 실행하고 결과를 보고 다시 고침 |
| 여러 파일 작업 | 파일마다 따로 설명 | 관련 파일을 스스로 찾아 함께 수정 |
핵심은 "고치고 → 실행하고 → 결과를 보고 → 다시 고치는" 반복을 클로드가 스스로 한다는 점입니다. 테스트가 실패하면 에러 메시지를 읽고 원인을 찾아 다시 수정합니다.
클로드 코드로 할 수 있는 일
제가 실제로 맡겨 본 작업들입니다.
- 코드베이스 파악: "이 프로젝트 구조를 설명해 줘. 빌드는 어디서 시작돼?" — 처음 보는 코드도 몇 분 만에 구조를 파악합니다.
- 기능 추가: "글마다 작성자 박스를 하단에 추가해 줘" — 템플릿 파일을 찾아 수정합니다.
- 버그 수정: 에러 메시지를 붙여 넣으면 관련 파일을 찾아 원인을 설명하고 고칩니다.
- 반복 작업 자동화: 이미지 수십 장 리사이즈, 파일 이름 일괄 변경 같은 스크립트 작성과 실행.
- Git 작업: 변경 내용 요약, 커밋 메시지 작성, PR 설명 작성.
권한 구조: 마음대로 바꾸지 않는다
처음 쓰는 분들이 가장 걱정하는 부분입니다. 클로드 코드는 기본적으로 파일 수정이나 명령 실행 전에 허락을 구합니다.
- 파일 읽기는 대부분 바로 진행합니다.
- 파일 수정, 셸 명령 실행은 허락 여부를 묻습니다.
- 자주 쓰는 안전한 명령은 "항상 허용"으로 등록할 수 있습니다.
- 실행 전에 계획만 세우게 하는 플랜 모드도 있습니다.
처음 일주일은 기본 설정 그대로 쓰면서 클로드가 무엇을 하려는지 하나씩 읽어 보는 것을 추천합니다. 그러다 보면 어떤 작업을 믿고 맡겨도 되는지 감이 생깁니다.
비개발자도 쓸 수 있을까
개발자가 아니어도 쓸 수 있습니다. 실제로 저는 다음 같은 일을 클로드 코드로 해결하는 비개발자 동료를 봤습니다.
- 폴더 안 엑셀 파일 수십 개를 하나로 합치기
- CSV에서 특정 조건의 행만 뽑아 새 파일 만들기
- 간단한 사내 공지 웹페이지 만들기
다만 두 가지는 꼭 지키라고 말합니다. 작업 전 폴더 백업, 그리고 허락 요청이 뜨면 내용을 읽어 보기입니다.
시작하려면 필요한 것
- Claude Pro 이상 구독 또는 API 키
- 윈도우·맥·리눅스 컴퓨터
- 작업할 프로젝트 폴더
설치 방법은 다음 글에서 윈도우 기준으로 자세히 정리하겠습니다.
한 줄씩 정리
- 클로드 코드는 프로젝트 파일을 직접 읽고 고치고 실행하는 AI 코딩 도구입니다.
- 대화창 코딩과 달리 수정·실행·재수정을 스스로 반복합니다.
- 기본적으로 수정·실행 전에 허락을 구하며, Pro 이상 구독이나 API 키가 필요합니다.
💬 써 보니 바뀐 역할
클로드 코드를 쓰면서 가장 크게 바뀐 건 "코드를 쓰는 사람"에서 "작업을 설명하고 검토하는 사람"으로 역할이 옮겨 간 것입니다. 편해진 만큼 검토 책임은 오히려 커졌습니다. 클로드가 고친 내용을 확인하지 않고 그대로 배포하면, 사람이 짠 코드보다 문제를 찾기 더 어려울 수 있습니다. 변경 사항을 읽는 습관만 들이면 체감 생산성은 확실히 높아집니다.
