최근 개발자들 사이에서 Claude Code 사용이 빠르게 늘어나고 있습니다. 특히 코드 생성뿐 아니라 프로젝트 탐색, 파일 수정, 테스트 작성까지 한 번에 처리할 수 있다는 점 때문에 생산성 도구로 자리 잡고 있습니다.
하지만 처음 사용하면 어떤 명령어를 써야 하는지 헷갈리는 경우가 많습니다. 이번 글에서는 현재 Claude Code 환경에서 가장 많이 사용하는 주요 명령어를 정리해 보겠습니다.
Claude Code는 앤트로픽이 제공하는 개발 환경 도구로, AI가 직접 코드 작업을 수행하도록 돕는 인터페이스입니다.
개발자는 자연어로 명령을 입력하고, Claude는 다음과 같은 작업을 수행합니다.
- 코드 생성
- 코드 수정
- 프로젝트 구조 분석
- 테스트 작성
- 문서 생성
즉 단순한 코드 생성기가 아니라 AI 기반 개발 에이전트에 가깝습니다.
아래는 실제 개발자들이 가장 많이 사용하는 핵심 명령어들입니다.
/help
사용 가능한 명령어 목록을 확인할 때 사용하는 기본 명령어입니다.
처음 Claude Code를 사용할 때 가장 먼저 입력하는 명령어입니다.
/help
이 명령어를 입력하면 현재 환경에서 사용할 수 있는 기능 목록을 확인할 수 있습니다.
/plan
작업을 시작하기 전에 AI가 작업 계획을 세우도록 요청하는 명령어입니다.
/plan create authentication system
Claude는 다음과 같은 계획을 제시합니다.
- 필요한 파일 구조
- 구현 단계
- 테스트 방법
- 예상 변경 파일
대규모 작업 전에 매우 자주 사용됩니다.
/edit
특정 파일을 수정할 때 사용하는 명령어입니다.
/edit src/auth/login.ts
이후 자연어로 수정 요청을 하면 Claude가 코드를 수정합니다.
예시
JWT 로그인 방식으로 변경해줘
/create
새 파일을 생성할 때 사용하는 명령어입니다.
/create src/api/user.ts
Claude는 해당 파일에 들어갈 기본 코드 구조까지 생성합니다.
/explain
코드 분석을 요청할 때 사용하는 명령어입니다.
/explain src/payment/paymentService.ts
Claude는 다음 내용을 설명합니다.
- 코드 역할
- 동작 흐름
- 개선 가능성
- 잠재적인 버그
기존 프로젝트를 이해할 때 매우 유용합니다.
/test
테스트 코드를 자동으로 생성할 때 사용하는 명령어입니다.
/test src/utils/validator.ts
Claude는 다음 테스트를 생성합니다.
- unit test
- edge case
- error case
특히 Jest나 Vitest 환경에서 자주 사용됩니다.
/refactor
코드를 리팩토링할 때 사용하는 명령어입니다.
/refactor src/services/orderService.ts
주로 다음 작업을 수행합니다.
- 코드 구조 개선
- 중복 코드 제거
- 함수 분리
- 성능 개선
/search
프로젝트 전체에서 특정 코드를 찾을 때 사용하는 명령어입니다.
/search "userRepository"
대규모 프로젝트에서 특정 로직을 찾을 때 매우 유용합니다.
/run
코드 실행이나 스크립트 실행을 요청할 때 사용합니다.
/run npm test
Claude가 실행 결과를 분석해 설명까지 제공합니다.
/commit
코드 변경 후 Git 커밋 메시지를 생성하는 명령어입니다.
/commit
Claude는 변경 내용을 분석해 커밋 메시지를 자동 생성합니다.
예시
feat: add JWT authentication system
개발자들이 가장 자주 사용하는 5가지 명령어
실제 사용 빈도를 기준으로 하면 다음 명령어가 가장 많이 사용됩니다.
1 /plan
2 /edit
3 /explain
4 /test
5 /refactor
이 다섯 개만 익혀도 Claude Code 활용도가 크게 올라갑니다.
다음 방법을 활용하면 작업 효율이 크게 올라갑니다.
첫 번째는 작업 전에 항상 계획을 세우는 것입니다.
/plan implement payment system
두 번째는 큰 파일보다 작은 단위로 수정 요청을 하는 것입니다.
세 번째는 agents.md와 함께 사용하는 것입니다.
agents.md를 작성하면 Claude가 프로젝트 구조를 더 정확히 이해합니다.
Claude Code 같은 AI 개발 도구는 기존 개발 방식에도 변화를 가져오고 있습니다.
과거에는
- 코드 작성
- 디버깅
- 문서 작성
을 개발자가 직접 처리했다면 이제는 AI가 상당 부분을 담당합니다.
개발자는 점점 설계와 검토 중심 역할로 이동하고 있습니다.
Claude Code는 단순한 코드 생성 도구가 아니라 개발 워크플로우 자체를 바꾸는 AI 도구입니다.
특히 다음 명령어만 익혀도 생산성이 크게 올라갑니다.
- /plan
- /edit
- /explain
- /test
- /refactor
AI 코딩 도구가 빠르게 발전하는 만큼, 이러한 명령어와 작업 방식에 익숙해지는 것이 앞으로 개발 생산성을 높이는 중요한 요소가 될 것입니다.
Claude Code를 처음 사용하는 개발자라면 위 명령어부터 하나씩 익혀보는 것을 추천합니다.
다른 글 더보기
By
