클로드 코드 사용방법

클로드 코드(Claude Code)는 터미널에서 자연어로 요청하면 프로젝트의 코드를 읽고, 수정하고, 테스트하거나 Git 작업까지 도와주는 코딩 도구입니다. 단순히 코드를 질문하는 것에서 끝나는 것이 아니라 현재 프로젝트의 파일을 살펴보고 실제 작업을 수행할 수 있다는 점이 특징입니다.

처음 사용한다면 설치 → 로그인 → 프로젝트 폴더에서 실행 → 자연어로 작업 요청 → 변경 내용 확인 순서만 익혀도 기본적인 활용이 가능합니다.

클로드 코드 사용 전 준비할 것

터미널에서 Claude Code를 사용하려면 먼저 다음 환경을 준비합니다.

터미널 또는 명령 프롬프트
작업할 코드 프로젝트
Claude Pro·Max·Team·Enterprise 구독, Claude Console 계정 또는 지원되는 클라우드 제공자를 통한 접근 권한

설치 방법과 명령어가 변경될 수 있으므로 처음 설치할 때는 Claude Code 빠른 시작 안내에서 현재 안내를 확인하는 것이 좋습니다.

Claude Code 빠른 시작 안내

1. Claude Code 설치하기

운영체제에 맞게 터미널에서 설치 명령을 실행합니다.

macOS·Linux·WSL

curl -fsSL [claude.ai](https://claude.ai/install.sh) | bash

macOS에서 Homebrew를 사용하고 있다면 다음 방법도 있습니다.

brew install --cask claude-code

Windows PowerShell

PowerShell을 실행한 뒤 다음 명령을 입력합니다.

irm [claude.ai](https://claude.ai/install.ps1) | iex

Windows CMD

명령 프롬프트에서는 다음 명령을 사용합니다.

curl -fsSL [claude.ai](https://claude.ai/install.cmd) -o install.cmd && install.cmd && del install.cmd

Windows에서는 현재 사용 중인 프로그램이 PowerShell인지 CMD인지 확인해야 합니다. 프롬프트 앞에 PS C:\가 보인다면 PowerShell이고, 일반적으로 C:\ 형태라면 CMD입니다.

네이티브 방식으로 설치한 Claude Code는 백그라운드에서 자동 업데이트됩니다. 반면 Homebrew나 WinGet으로 설치했다면 해당 패키지 관리자를 통해 업데이트해야 합니다.

2. Claude 계정으로 로그인하기

설치가 끝났다면 터미널에서 다음 명령을 실행합니다.

claude

처음 실행하는 경우 로그인 안내가 표시됩니다. Claude 구독이나 Console 계정을 이용한다면 안내에 따라 브라우저에서 인증을 완료하면 됩니다.

이미 Claude Code를 실행한 상태에서 계정을 바꾸거나 다시 인증하려면 다음 명령을 사용할 수 있습니다.

/login

로그인 정보는 시스템에 저장되기 때문에 일반적으로 실행할 때마다 다시 로그인할 필요는 없습니다.

3. 프로젝트 폴더에서 Claude Code 실행하기

Claude Code는 작업하려는 프로젝트 디렉터리에서 실행하는 것이 기본입니다.

예를 들어 프로젝트가 my-project 폴더에 있다면 해당 위치로 이동합니다.

cd /path/to/my-project
claude

Claude Code가 실행되면 현재 프로젝트를 대상으로 대화를 시작할 수 있습니다.

처음 접하는 프로젝트라면 바로 코드를 수정시키기보다 구조부터 파악해 보는 것이 편합니다.

이 프로젝트는 무엇을 하나요?

또는 다음과 같이 질문할 수 있습니다.

이 프로젝트에서 사용하는 기술을 정리해줘

주요 진입점이 어디인지 찾아줘

폴더 구조를 설명하고 각 폴더의 역할을 알려줘

Claude Code는 필요한 프로젝트 파일을 직접 확인하기 때문에 모든 코드를 일일이 복사해서 프롬프트에 붙여 넣을 필요가 없습니다.

4. 실제 코드 수정 요청하기

프로젝트를 어느 정도 파악했다면 자연어로 원하는 작업을 요청하면 됩니다.

간단하게는 다음과 같이 지시할 수 있습니다.

주 파일에 hello world 함수 추가해줘

Claude Code는 관련 파일을 찾고 변경할 내용을 제안한 다음 필요한 권한을 요청해 작업을 진행합니다.

실제 프로젝트에서는 작업 범위를 조금 더 구체적으로 지정하는 편이 좋습니다.

로그인 폼을 확인하고 이메일 입력값 검증 기능을 추가해줘.
기존 코드 스타일은 유지하고 관련 테스트가 있다면 함께 수정해줘.

단순히 버그 수정해줘라고 입력하는 것보다 어디에서 어떤 문제가 발생하며 원하는 결과가 무엇인지 설명하면 작업 범위를 파악하기 쉬워집니다.

5. 버그 수정과 기능 개발에 활용하기

Claude Code는 기존 코드에서 문제와 관련된 부분을 찾고 수정하는 방식으로 사용할 수 있습니다.

예를 들어 회원가입 기능에 문제가 있다면 다음처럼 요청할 수 있습니다.

사용자가 빈 회원가입 양식을 제출할 수 있는 문제가 있어.
관련 코드를 찾아서 원인을 설명하고 수정해줘.
가능하면 기존 테스트도 실행해서 확인해줘.

새 기능도 자연어로 요청할 수 있습니다.

사용자 등록 폼에 입력 유효성 검사를 추가해줘

작업 내용이 크다면 한 번에 많은 기능을 요청하기보다 단계별로 나누는 것이 좋습니다.

1. 사용자 프로필에 관련된 현재 코드를 찾아줘.
2. 수정이 필요한 파일과 구현 방법을 먼저 설명해줘.
3. 내가 확인한 다음 코드를 변경해줘.

이렇게 요청하면 바로 여러 파일을 수정시키기보다 먼저 구현 방향을 검토할 수 있습니다.

Git 작업도 자연어로 요청 가능

Claude Code에서는 코드 작성뿐 아니라 Git과 관련된 작업도 요청할 수 있습니다.

현재 변경된 파일을 확인하고 싶다면 다음처럼 입력합니다.

어떤 파일을 변경했나요?

커밋이 필요하다면 다음과 같은 요청도 가능합니다.

변경 사항을 확인하고 설명적인 메시지로 커밋해줘

브랜치 작업이나 이전 커밋 확인도 요청할 수 있습니다.

feature/login이라는 새 브랜치를 만들어줘

최근 5개 커밋을 보여주고 주요 변경 내용을 설명해줘

현재 병합 충돌이 발생한 파일을 확인하고 해결 방법을 설명해줘

특히 실제 저장소에서는 Claude가 제안한 변경 내용을 확인한 뒤 커밋하는 습관을 들이는 것이 안전합니다.

자주 사용하는 Claude Code 명령어

터미널에서 알아두면 편한 기본 명령은 다음과 같습니다.

명령어	용도
`claude`	대화형 Claude Code 실행
`claude "task"`	특정 작업을 바로 실행
`claude -p "query"`	쿼리를 실행하고 종료
`claude -c`	현재 디렉터리의 최근 대화 계속
`claude -r`	이전 대화 선택 후 재개

Claude Code를 실행한 세션 내부에서도 명령을 사용할 수 있습니다.

명령어	용도
`/help`	사용할 수 있는 명령 확인
`/clear`	현재 대화 기록 지우기
`/exit`	Claude Code 종료
`/login`	계정 로그인 또는 재인증

이전 작업을 이어서 진행해야 할 때는 최근 대화를 계속하거나 이전 세션을 재개하는 기능을 활용하면 편리합니다.

처음 사용할 때 유용한 프롬프트

Claude Code는 개발자가 옆에 있는 동료에게 업무를 설명하듯 요청하는 방식이 잘 맞습니다.

코드를 이해하고 싶다면:

이 프로젝트의 전체 구조를 분석하고 초보자가 이해하기 쉽게 설명해줘.
중요한 파일과 실행 흐름을 중심으로 알려줘.

버그를 고치고 싶다면:

로그인 버튼을 눌렀을 때 빈 화면이 나타나는 원인을 찾아줘.
관련 코드를 먼저 분석하고 원인을 설명한 다음 수정해줘.

리팩토링이 필요하다면:

인증 모듈을 검토하고 중복 코드를 찾아줘.
현재 동작을 변경하지 않는 범위에서 리팩토링하고 테스트도 확인해줘.

코드 리뷰를 받고 싶다면:

현재 변경 사항을 코드 리뷰해줘.
버그 가능성, 보안 문제, 가독성, 유지보수성 순서로 확인해줘.

테스트가 필요하다면:

이번에 변경한 코드에 필요한 단위 테스트를 작성하고 실행해줘.
실패하는 테스트가 있으면 원인도 설명해줘.

Claude Code를 사용할 때 기억할 점

Claude Code의 장점은 프로젝트 파일을 직접 살펴보면서 작업할 수 있다는 데 있지만, AI가 생성하거나 수정한 코드를 검토하지 않고 바로 배포하는 것은 피하는 편이 좋습니다.

특히 인증, 결제, 개인정보, 데이터베이스 마이그레이션처럼 오류의 영향이 큰 부분은 변경된 코드를 직접 확인하고 테스트 결과도 검증해야 합니다. Git을 사용하고 있다면 작업 전에 브랜치를 분리하거나 현재 변경 사항을 확인해 두는 것도 유용합니다.

처음에는 프로젝트 설명 요청 → 수정 계획 확인 → 작은 작업 요청 → 변경 내용 검토 → 테스트 → Git 커밋 순서로 사용해 보면 Claude Code의 작업 방식을 익히기 쉽습니다. 익숙해진 뒤에는 리팩토링, 테스트 작성, 문서 업데이트, 코드 리뷰, 버그 수정과 같은 반복적인 개발 업무까지 활용 범위를 넓힐