클로드한테 코드를 복사해서 붙여넣고, 수정된 결과를 다시 복사해서 파일에 덮어쓴 적 있는가?
블로그 글도 마찬가지다. “이전에 알려준 톤 기억해?”라고 물었는데, 새 대화라 처음부터 다시 설명해야 했던 경험이 있다면 — 이 글이 그 루틴을 끊는 방법을 보여준다.
1편에서 클로드와 클로드 코드의 구조적 차이를 정리했다. 이번 편은 실전이다. 블로그 글 수정, 코드 리팩토링, 데이터 분석 — 같은 작업을 양쪽에서 돌려보고, 결과가 어떻게 갈리는지 비교한다.
대화창에 붙여넣고, 결과를 다시 복사하고 있다면
웹 클로드로 코드를 수정하는 흐름은 늘 같은 패턴을 탄다. 파일 내용을 복사해서 대화창에 붙이고, 수정을 요청하고, 나온 결과를 다시 복사해서 에디터에 붙인다. 파일이 세 개면 이 과정을 세 번 반복한다.
더 큰 문제가 있다. 웹 클로드는 대화 단위로 기억이 끊긴다. 어제 설명한 코딩 컨벤션, 블로그 톤앤매너, 프로젝트 폴더 구조 — 새 대화를 열면 전부 사라진다. Projects 기능으로 일부 보완되지만, 내 컴퓨터의 파일을 직접 건드리지는 못한다.
도구가 부족한 게 아니다. 대화창이라는 형식 자체가 파일을 직접 다루는 작업과 구조적으로 맞지 않는 것이다.
매번 설명하지 않아도 맥락이 유지되는 구조
클로드 코드는 프로젝트 폴더 루트에 CLAUDE.md라는 파일 하나를 둔다. 여기에 적힌 내용은 새 대화를 시작해도 매번 자동으로 읽힌다.
블로거라면 글 톤, 금지 표현, SEO 규칙을 적어둔다. 개발자라면 코드 스타일, 테스트 명령어, 폴더 구조 설명을 넣는다. 한 번 적어두면 다음 대화부터 반복 설명이 사라진다.
웹 클로드의 Projects 지침과 비슷해 보이지만, 결정적 차이가 있다. CLAUDE.md는 코드 저장소(Git)에 함께 들어가기 때문에 변경 이력이 추적된다. 게다가 클로드 코드가 작업 도중 새로 파악한 정보 — 빌드 명령어라든가, 특정 폴더의 역할 — 을 이 파일에 직접 추가하기도 한다. 쓸수록 맥락이 두꺼워지는 구조다.
블로그 글 10개를 한 마디로 수정하는 법
같은 작업을 양쪽에서 해본다고 하자. 요청은 “마크다운 파일의 제목을 SEO에 맞게 바꾸고, 본문 도입부를 다시 써줘.”
웹 클로드에서는 Artifacts 패널에 수정된 전체 글이 나온다. 미리보기가 되고 보기 편하다. 하지만 결국 복사해서 파일에 붙여넣는 건 사람 몫이다. 글 10개면 이 과정을 10번 해야 한다.
클로드 코드는 다르다. 터미널에서 프로젝트 폴더를 열고 명령하면, 실제 파일을 열어 해당 부분만 수정하고 저장까지 마친다. 10개 파일이든 20개든, 하나씩 순서대로 처리한다. 수정 전에 변경 사항을 보여주고, 승인하면 적용하는 흐름이라 실수로 덮어쓸 걱정도 없다.
/posts 폴더에서 최근 마크다운 글 5개를 읽고 아래 작업을 해줘.
1. 각 글의 제목을 SEO 기준으로 수정 (변경 전 → 후 보여주기)
2. meta description이 없는 글에 80~100자로 추가
3. 본문에 H2가 하나도 없으면 적절한 위치에 소제목 추가
각 파일의 변경 사항을 먼저 보여주고, 내가 승인하면 적용해.
이 프롬프트 하나로 클로드 코드는 파일을 읽고, 분석하고, 수정안을 제시하고, 승인 후 저장까지 이어간다. 블로그 폴더에 마크다운 파일이 쌓여 있다면, 이 방식부터 시도해볼 만하다.
리팩토링과 데이터 분석, 웹 클로드와 나란히 비교
코드 리팩토링. 웹 클로드에 함수 하나를 붙여넣고 “리팩토링해줘”라고 하면 깔끔한 결과가 나온다. 하지만 그 함수를 호출하는 다른 파일까지는 보지 못한다. 의존성을 파악하려면 관련 코드를 전부 직접 찾아서 붙여넣어야 한다.
클로드 코드는 프로젝트 전체 파일을 탐색한다. “이 함수를 리팩토링하고, 호출하는 곳도 같이 수정해줘”라고 하면 연관 파일까지 찾아서 고친다. 수정 후 터미널에서 테스트 명령어를 실행해 통과 여부까지 확인해준다.
src/utils/formatDate.ts의 formatDate 함수를 리팩토링해줘.
조건:
- day.js 의존성을 제거하고 Intl.DateTimeFormat으로 교체
- 이 함수를 import하는 모든 파일을 찾아서 호출 방식이 바뀌면 같이 수정
- 수정 후 기존 테스트 실행해서 통과하는지 확인
테스트 명령어: npm run test -- --filter formatDate
데이터 분석. CSV를 웹 클로드에 올리면 Artifacts로 차트와 표가 바로 화면에 뜬다. 시각적 탐색 단계에서는 오히려 웹 클로드가 빠르고 직관적이다. 그런데 같은 분석을 다음 달에 또 해야 한다면? 매번 파일을 올리고 같은 요청을 반복해야 한다.
클로드 코드는 접근이 다르다. Python 스크립트를 직접 만들고 터미널에서 실행한다. 분석 결과가 파일로 저장되고, 재사용 가능한 스크립트가 남는다. 월간 리포트처럼 정기적으로 반복하는 분석에 강하다.
웹 클로드: 파일 복붙 → Artifacts에서 결과 확인 → 수동 적용. 새 대화마다 맥락 재설명. 한 파일씩 처리.
클로드 코드: “이 폴더 전부 수정해줘” 한 마디. CLAUDE.md로 맥락 자동 유지. 여러 파일 연속 처리 + 테스트 실행까지.
정리하면, 한 번 쓰고 마는 탐색이나 초안 작업은 웹 클로드의 Artifacts가 빠르다. 여러 파일을 건드리거나 반복되는 업무라면 클로드 코드가 압도적이다. 둘 다 같은 Claude 모델을 쓴다 — 차이는 모델 성능이 아니라 작업 환경이다.
자주 묻는 질문
Q. 클로드 코드를 처음 쓰는데 어디부터 시작하나요?
클로드 코드는 터미널에서 실행되는 도구로, Node.js 설치 후 명령어 한 줄로 설치할 수 있다. 설치 과정과 초기 세팅은 다음 편(3편)에서 단계별로 다룬다. Pro 또는 Max 요금제에 포함되며, 정확한 가격과 플랜 구성은 Anthropic 공식 요금 페이지에서 확인할 수 있다.
Q. 웹 클로드의 Artifacts와 클로드 코드의 파일 수정은 뭐가 다른가요?
Artifacts는 대화 안에서 코드·표·차트 등 결과물을 시각적으로 미리 보여주는 기능이다. 확인은 편하지만, 내 컴퓨터의 파일을 직접 수정하지는 못한다. 클로드 코드는 프로젝트 폴더 안의 실제 파일을 열고, 해당 부분만 수정하고, 저장까지 한다.
Q. CLAUDE.md를 직접 안 써도 되나요?
“이 프로젝트의 CLAUDE.md를 만들어줘”라고 요청하면, 클로드 코드가 폴더 구조와 코드를 분석해서 초안을 작성해준다. 그 초안에 톤 규칙이나 금지 표현 같은 세부 사항만 추가하면 된다. 이후 작업 중에 새로 파악한 정보를 클로드 코드가 이 파일에 직접 업데이트하기도 한다.
도구가 아니라 작업 방식이 달라지는 것
웹 클로드와 클로드 코드는 같은 AI 모델이 다른 환경에서 돌아가는 것이다. 대화창에서 잘 되는 일이 있고, 터미널에서 잘 되는 일이 있다. 핵심은 내 반복 업무가 어디에 해당하는지 판단하는 것이다.
이제 클로드 코드를 한번 써보고 싶은데 설치부터 막히는가? 다음 편에서 5분 안에 설치하고 첫 프로젝트를 세팅하는 과정을 다룬다. → 클로드 코드 설치부터 실전 세팅까지｜초보자 5분 시작 가이드