안녕하세요
오늘은 Claude Code(클로드 코드) 사용 시 주로 사용하는 명령어 & 단축키 & 실전 활용 팁에 대해 정리해 보았습니다.
1. 기본 시작 명령어
1-1) claude 실행하기
가장 먼저 알아야 할 명령어입니다. 프로젝트 폴더에서 터미널을 열고 다음과 같이 입력하면 됩니다.
claude
이 한 줄이면 클로드 코드가 실행됩니다. 처음 실행하면 테마 설정과 로그인 화면이 나타납니다. 구독 계정이 있다면 계정 연동을, API를 사용한다면 API 키를 입력하면 됩니다
1-2) 프로젝트 초기화
새 프로젝트에서 클로드 코드를 처음 사용한다면 다음 명령어가 유용합니다.
/init
이 명령어를 실행하면 프로젝트 루트에 CLAUDE.md 파일이 자동 생성됩니다. 이 파일은 클로드 코드가 프로젝트를 이해하는 데 필요한 핵심 정보를 담고 있어서, 매번 같은 설명을 반복하지 않아도 됩니다
2. 설정 관련 필수 명령어
2-1) 설정 메뉴 열기
클로드 코드의 각종 설정을 변경하려면 다음 명령어를 사용합니다.
/config
이 명령어로 모델 선택, 권한 설정, 테마 변경 등 다양한 옵션을 조정할 수 있습니다. 특히 Sonnet과 Opus 모델 간 전환이 가능해서 작업 특성에 맞게 선택할 수 있습니다
2-2) 모델 변경하기
작업 중에 모델을 바꾸고 싶다면 다음 명령어를 사용합니다.
/model
간단한 작업에는 빠른 Sonnet 모델을, 복잡한 아키텍처 설계에는 강력한 Opus 모델을 선택하는 식으로 상황에 맞게 활용할 수 있습니다
2-3) 허용 도구 관리
클로드 코드가 어떤 작업을 할 수 있는지 제어하려면 이 명령어가 필요합니다.
/allowed-tools파일 읽기, 쓰기, bash 명령 실행 등 각종 도구에 대한 권한을 설정할 수 있습니다. 보안이 중요한 프로젝트에서는 반드시 확인해야 하는 부분입니다
3. 작업 효율을 높이는 핵심 명령어
3-1) 도움말 보기
어떤 명령어가 있는지 잊어버렸다면 다음을 입력합니다.
/help
사용 가능한 모든 명령어 목록과 간단한 설명이 표시됩니다. 처음 사용할 때는 이 명령어로 전체적인 기능을 파악하는 것이 좋습니다
3-2) 대화 내용 정리
대화가 길어지면 토큰 사용량이 늘어나고 응답이 느려집니다. 이럴 때 사용하는 명령어입니다.
/clear
현재까지의 대화 기록을 지우고 새로운 세션을 시작합니다. 완전히 다른 주제로 넘어갈 때 유용합니다
3-3) 대화 압축하기
대화 내용을 유지하면서 토큰만 줄이고 싶다면 이 명령어를 사용합니다.
/compact
중요한 정보는 요약해서 보존하고 불필요한 부분을 제거해 줍니다. 긴 작업을 이어서 할 때 특히 유용합니다 📦
3-4) 상태 확인하기
현재 사용 중인 모델, 남은 토큰, 비용 등을 확인하려면 다음 명령어를 입력합니다.
/status
API를 사용한다면 얼마나 사용했는지 실시간으로 체크할 수 있어서 비용 관리에 도움이 됩니다
3-5) 비용 확인하기
더 자세한 비용 정보를 보려면 이 명령어를 사용합니다.
/cost
총 비용, API 처리 시간, 실제 소요 시간, 코드 변경 내역 등이 표시됩니다. 캐시 사용량도 확인할 수 있어서 최적화에 참고할 수 있습니다
4. 필수 키보드 단축키
4-1) 명령 취소하기
클로드가 잘못된 작업을 시작했다면 즉시 중단할 수 있습니다.
Ctrl + C
작업이 멈추고 다시 명령을 입력할 수 있는 상태가 됩니다
4-2) 여러 줄 입력하기
긴 요청사항을 입력할 때는 다음 키 조합을 사용합니다.
Shift + Enter
줄바꿈이 되면서 여러 줄의 프롬프트를 작성할 수 있습니다. 복잡한 요구사항을 정리해서 전달할 때 필수입니다
4-3) 이전 명령 불러오기
이전에 입력했던 명령을 다시 사용하고 싶다면 방향키를 사용합니다.
위쪽 화살표 ↑
아래쪽 화살표 ↓
터미널처럼 명령 히스토리를 탐색할 수 있어서 반복 작업이 편리합니다
4-4) 백그라운드 실행
시간이 오래 걸리는 bash 명령을 백그라운드로 돌리려면 다음을 사용합니다.
Ctrl + B
명령이 백그라운드에서 실행되는 동안 다른 작업을 계속할 수 있습니다. 테스트나 빌드를 돌리면서 코드를 수정하는 등 멀티태스킹이 가능합니다
5. 고급 활용 명령어
5-1) 커스텀 명령어 만들기
자주 사용하는 작업은 슬래시 명령어로 만들어 두면 편리합니다. 프로젝트 루트에 .claude/commands 폴더를 만들고 마크다운 파일을 생성합니다.
예를 들어 .claude/commands/test.md 파일에 다음과 같이 작성합니다:
테스트를 실행하고 실패한 테스트가 있으면 자동으로 수정해줘.
커버리지 리포트도 생성하고 커밋 메시지와 함께 커밋해줘.
이후 /test만 입력하면 위 작업이 자동으로 실행됩니다
5-2) IDE 연동
사용 중인 IDE를 클로드 코드와 연동할 수 있습니다.
/ide
VS Code, IntelliJ, Cursor 등과 연동되어 diff 뷰어를 IDE에서 바로 볼 수 있습니다. 코드 변경사항을 더 편하게 확인할 수 있습니다
5-3) MCP 서버 관리
외부 도구나 API를 연결하려면 MCP(Model Context Protocol) 서버를 추가합니다.
/mcp add
/mcp list
/mcp remove
데이터베이스, GitHub, AWS 등 다양한 서비스와 연동할 수 있어서 개발 환경을 확장할 수 있습니다
5-4) 터미널 설정
터미널 설정을 최적화하려면 다음 명령어를 실행합니다.
/terminal-setup
iTerm2나 VS Code 터미널에서 Shift+Enter 단축키 바인딩을 자동으로 설정해 줍니다
6. 실전 활용 팁
6-1) 프롬프트 작성 요령
클로드 코드에게 명령할 때는 구체적으로 작성하는 것이 중요합니다.
나쁜 예시:
로그인 기능 추가해줘
좋은 예시:
JWT 토큰 기반 로그인 API를 만들어줘.
- /api/auth/login 엔드포인트
- 이메일과 비밀번호 검증
- 성공 시 액세스 토큰과 리프레시 토큰 반환
- Spring Security 사용
구체적일수록 원하는 결과를 정확하게 얻을 수 있습니다
6-2) CLAUDE.md 파일 활용
프로젝트 루트의 CLAUDE.md 파일을 잘 작성하면 매번 같은 설명을 반복하지 않아도 됩니다. 다음과 같은 내용을 포함시키면 좋습니다:
- 프로젝트 구조와 목적
- 사용 중인 기술 스택
- 빌드 및 실행 명령어
- 코딩 컨벤션
- 주의사항
클로드 코드가 대화를 시작할 때마다 이 파일을 자동으로 읽어서 컨텍스트를 파악합니다
6-3) 백그라운드 작업 활용
긴 작업은 백그라운드로 돌리고 다른 일을 하면 시간을 절약할 수 있습니다.
"백그라운드에서 전체 테스트를 실행해줘"
또는 Ctrl+B를 눌러서 수동으로 백그라운드로 전환할 수 있습니다. 작업이 완료되면 알림이 표시됩니다
6-4) 파일 드래그 앤 드롭
파일을 직접 입력하려면 터미널에 드래그 앤 드롭하면 됩니다. Shift를 누른 채로 드래그하면 파일 경로가 자동으로 입력됩니다
6-5) 이미지 붙여넣기
스크린샷이나 디자인 이미지를 보여주려면 Ctrl+V (Mac에서는 Cmd+V가 아님)로 붙여넣을 수 있습니다. 이미지를 분석해서 코드로 구현해 줍니다
7. 실무 활용 시나리오
7-1) 버그 수정하기
이 에러 로그를 분석하고 원인을 찾아서 수정해줘
[에러 로그 붙여넣기]
클로드가 에러를 분석하고, 관련 파일을 찾아서, 수정 방법을 제안하고, 직접 코드를 수정합니다
7-2) 리팩토링 요청
UserService 클래스를 분석하고 다음 원칙으로 리팩토링해줘:
- 단일 책임 원칙 적용
- 의존성 주입 패턴 사용
- 테스트 코드도 함께 작성
복잡한 리팩토링도 단계별로 진행하면서 설명과 함께 처리합니다
7-3) 문서 작성
이 API 엔드포인트들에 대한 README 파일을 작성해줘.
Swagger 문서도 함께 생성해줘.
코드를 분석해서 자동으로 문서를 생성해 줍니다
7-4) Git 작업
변경사항을 확인하고 의미 있는 커밋 메시지를 작성해서 커밋하고,
PR을 만들어서 푸시해줘.
Git 작업도 자연어 명령으로 처리할 수 있습니다
8. 주의사항
8-1) 메모리 관리
클로드 코드는 각 세션마다 메모리가 리셋됩니다. 중요한 정보는 CLAUDE.md 파일이나 코드 주석으로 남겨두는 것이 좋습니다. 마치 매일 기억을 잃는 신입 개발자를 위해 문서를 잘 정리해두는 것과 같습니다
8-2) 토큰 사용량 관리
대화가 길어지면 토큰이 빠르게 소모됩니다. /compact나 /clear 명령어로 주기적으로 정리하는 습관을 들이면 좋습니다.
8-3) 권한 설정
프로덕션 환경에서는 --dangerously-skip-permissions 플래그를 사용하지 않는 것이 안전합니다. 개발 환경에서만 편의를 위해 사용하는 것이 좋습니다
8-4) 결과 검증
AI가 생성한 코드는 항상 검토가 필요합니다. 특히 보안과 관련된 부분이나 중요한 비즈니스 로직은 반드시 확인해야 합니다
9. 마무리하며
클로드 코드는 단순히 코드를 자동완성해주는 도구가 아닙니다. 터미널이라는 개발자의 핵심 작업 공간에서 모든 개발 프로세스를 지원하는 강력한 파트너입니다.
처음에는 명령어가 낯설 수 있지만, 몇 번 사용하다 보면 손에 익습니다. 특히 /help, /config, /status 세 가지 명령어만 기억해도 기본적인 사용에는 문제가 없습니다.
아직 사용해보지 않았다면, 지금 바로 터미널을 열고 claude를 입력해보시기 바랍니다
10. 함께 공부하기 좋은 참고 자료
- Claude Code 공식 문서 - 가장 정확하고 최신 정보
- Claude Code 대화형 모드 가이드 - 키보드 단축키와 명령어 상세 설명
- Claude Code 사용 가이드 - 하이퍼리즘 - 실전 활용 팁과 MCP 서버 연동
- 초보를 위한 Claude Code 안내서 - 실제 프로젝트 적용 경험담
- 10배 생산성을 높이는 20가지 Claude Code CLI 명령어 - 심화 명령어와 워크플로우
'IT > AI' 카테고리의 다른 글
| Claude Code(클로드 코드) 사용 시 토큰 비용 절약 꿀팁 총정리! (0) | 2025.12.24 |
|---|---|
| Claude Code(클로드 코드) 인증 정보 삭제하기(초기화하기) (0) | 2025.12.23 |
| Claude Code 요금제 완벽 정리 : Pro 구독 vs API 종량제, 개발자의 선택은? (0) | 2025.12.23 |
| Claude Code 를 활용한 바이브코딩 시작하기(클로드 코드 설치 및 실행하기) (0) | 2025.12.22 |
댓글