클로드 코드 사용법을 제대로 알아두면 터미널 창 하나로 여러 파일에 걸친 코드 수정을 AI에게 맡기고, 사람은 결과만 검토하는 방식으로 개발 속도를 크게 끌어올릴 수 있습니다. 설치부터 실제 버그 수정 요청, 자주 만나는 오류까지 처음 써보는 사람 기준으로 순서대로 정리했습니다.
클로드 코드 핵심요약
클로드 코드 사용법의 핵심은 npm으로 설치한 뒤 터미널에서 프로젝트 폴더로 이동해 세션을 열고, 가장 먼저 /init 명령으로 프로젝트를 스캔해 CLAUDE.md 파일을 만드는 것입니다. 이후 사람이 하듯 자연어로 작업을 요청하면 여러 파일에 걸친 수정도 알아서 처리하고, 최종 diff만 사람이 검토하면 됩니다.
설치하기
설치 전에 Node.js 18 이상이 컴퓨터에 설치되어 있어야 합니다. 터미널을 열고 npm install -g @anthropic-ai/claude-code 명령을 입력하면 전역으로 설치됩니다. 설치가 끝나면 claude 명령으로 실행할 수 있고, 처음 실행 시 브라우저 창이 뜨면서 Anthropic 계정으로 로그인하라는 안내가 나옵니다. 로그인만 마치면 이후에는 터미널에서 claude만 입력해 바로 세션을 시작할 수 있습니다. 터미널 CLI가 기본이지만, VS Code나 Cursor를 쓴다면 확장 프로그램을 설치해 에디터 사이드바에서 같은 방식으로 쓸 수도 있고, JetBrains 계열(IntelliJ, PyCharm, WebStorm) 플러그인도 지원합니다.
첫 실행과 /init 명령
프로젝트 폴더에서 claude 명령으로 세션을 열면, 가장 먼저 /init을 입력하는 것을 추천합니다. 이 명령은 프로젝트의 폴더 구조, 사용 중인 프레임워크, package.json이나 설정 파일들을 스캔해서 CLAUDE.md라는 파일을 자동으로 만들어줍니다. 이 파일에는 보통 “이 프로젝트는 Next.js 기반이며 src/components에 컴포넌트가 있다”처럼 프로젝트를 요약한 내용이 담기는데, 이후 모든 대화에서 클로드가 이 파일을 참고하기 때문에 매번 프로젝트 구조를 설명할 필요가 없어집니다. 팀에서 함께 쓴다면 이 파일을 git에 커밋해두고 팀원들과 공유하는 것도 좋은 방법입니다.
실전 예시: 버그 수정 요청해보기
감을 잡기 위해 실제로 자주 나오는 상황을 하나 살펴보겠습니다. 로그인 페이지에서 비밀번호 필드에 특수문자를 입력하면 에러가 나는 버그가 있다고 가정해보겠습니다. 세션을 연 상태에서 “로그인 페이지에서 비밀번호에 특수문자를 넣으면 500 에러가 나는데, 원인을 찾아서 고쳐줘”처럼 증상을 구체적으로 설명하면, 클로드 코드는 먼저 관련 파일(로그인 컴포넌트, 유효성 검사 로직, 백엔드 API 라우트 등)을 스스로 검색합니다. 원인을 찾으면 어느 파일의 몇 번째 줄이 문제인지 설명하고, 수정할 코드를 diff 형태로 보여줍니다. 여기서 바로 적용하지 말고, 제안된 수정 내용을 한 줄씩 읽어보고 의도와 다른 부분이 있으면 “이 부분은 그대로 두고 정규식만 수정해줘”처럼 추가 지시를 내리면 됩니다. 승인하면 실제 파일에 반영되고, 이어서 “테스트 코드도 하나 추가해줘”라고 요청하면 방금 고친 버그에 대한 테스트까지 이어서 작성해줍니다.
자주 만나는 오류와 해결법
처음 쓸 때 자주 마주치는 문제 몇 가지를 정리하면 다음과 같습니다. “permission denied” 오류가 나면 npm 전역 설치 경로 권한 문제인 경우가 많은데, sudo 없이 설치하려면 nvm으로 Node.js를 관리하는 것을 추천합니다. API 사용량 한도에 걸려 응답이 멈추는 경우는 요금제 한도를 확인해야 하고, 무료·Pro 플랜은 하루 사용량에 제한이 있어 대규모 리팩토링처럼 무거운 작업을 반복하면 금방 한도에 도달할 수 있습니다. 또 응답이 유독 느리게 느껴진다면 프로젝트 폴더 자체가 너무 크거나 node_modules처럼 스캔할 필요 없는 폴더까지 포함되어 있는 경우가 많으니, .gitignore에 있는 폴더는 자동으로 제외되는지 확인해보는 것이 좋습니다.
터미널 CLI vs 에디터 확장 프로그램
| 구분 | 터미널 CLI | 에디터 확장 프로그램 |
|---|---|---|
| 설치 난이도 | npm 명령 한 줄 | 마켓플레이스에서 검색 후 설치 |
| 사용 환경 | 어떤 에디터와도 무관하게 독립 실행 | VS Code, Cursor, JetBrains 내부 통합 |
| 적합한 사용자 | 터미널이 익숙한 개발자 | 에디터 안에서 모든 걸 끝내고 싶은 사용자 |
안전하게 쓰는 팁
코드 변경 전에는 항상 diff를 꼼꼼히 확인하는 습관이 중요합니다. 특히 삭제되는 코드가 있다면 왜 지워지는지 이유를 반드시 확인하세요. 처음에는 버그 수정이나 작은 리팩토링처럼 범위가 명확한 작업부터 맡기고, 익숙해지면 새 기능 추가처럼 더 큰 단위로 넓혀가는 방식을 추천합니다. 운영 서버에 바로 배포되는 브랜치에서 작업할 때는 반드시 별도 브랜치를 만들어 작업하고, 리뷰를 거친 뒤 병합하는 절차를 그대로 유지하는 것이 안전합니다.
클로드 코드와 요금제
클로드 코드 같은 도구는 무료 플랜이 아닌 Pro 플랜부터 포함되므로, 개발 업무에 자주 활용할 계획이라면 클로드 공식 요금제 페이지에서 최신 가격과 사용량 한도를 미리 확인해보는 것이 좋습니다. 특히 하루 단위로 리팩토링을 여러 번 돌리는 개발자라면 Max 플랜까지 고려해볼 만합니다.
마무리
클로드 코드 사용법은 처음엔 낯설어도 설치, /init, 그리고 구체적인 자연어 요청이라는 세 단계만 익히면 금방 손에 붙습니다. 처음부터 큰 작업을 맡기기보다 작은 버그 수정부터 시작해서 diff를 확인하는 습관을 들이면, 터미널이 낯선 사람도 무리 없이 적응할 수 있습니다.
자주 묻는 질문
클로드 코드를 쓰려면 개발 지식이 많이 필요한가요?
기본적인 터미널 사용법과 git 개념 정도만 알아도 시작할 수 있고, 나머지는 클로드가 대화로 안내해주는 편입니다.
클로드 코드는 어떤 요금제부터 쓸 수 있나요?
클로드 코드 같은 도구는 Pro 플랜부터 포함되므로 무료 플랜만으로는 제한이 있을 수 있습니다.
기존 프로젝트에 적용해도 안전한가요?
네, 다만 반드시 별도 브랜치에서 작업하고 diff를 확인한 뒤 병합하는 절차를 거치면 기존 코드베이스에도 안전하게 적용할 수 있습니다.
여러 파일을 한 번에 수정하는 게 정말 정확한가요?
간단한 버그 수정이나 리팩토링은 정확도가 높은 편이지만, 복잡한 아키텍처 변경은 결과를 반드시 사람이 검토하고 테스트를 거쳐야 합니다.