Claude Code 사용법 및 주요 명령 (필요하신 스터디원분들은 참고하세요!)
유쾌한 사슴 · 에이전트 / 노코드 자동화 · · 좋아요 0 · 답글 0
연재 문서 자동화 시스템 설계 2/5편
클로드코드 사용법이 익숙하지 않은 스터디원분들을 위해서
정리해서 올리는 내용입니다.
필요하신 분들은 참고해서 활용하세요!
이 내용은 Claude code의 도움으로 제작되었습니다.
Claude Code 완벽 가이드
Anthropic의 공식 CLI 도구 Claude Code의 주요 명령어, 단축키, 사용법 정리 작성일: 2026-05-18
설치
# npm으로 설치
npm install -g @anthropic-ai/claude-code
# 또는 공식 인스톨러
curl -fsSL https://claude.ai/install.sh | bash
첫 실행
# 프로젝트 디렉토리로 이동 후 실행
cd my-project
claude
# 특정 모델 지정
claude --model claude-opus-4-7
claude --model claude-sonnet-4-6
로그인
# 대화창에서
/login
세션 관리
명령어
설명
/help
전체 도움말 표시
/clear
대화 컨텍스트 완전 초기화
/compact
긴 대화를 요약하여 컨텍스트 절약
/resume
이전 세션 재개
/exit
Claude Code 종료
/status
현재 세션 상태 확인
/cost
토큰 사용량 및 비용 확인
/export
대화 내용 마크다운으로 내보내기
설정 및 환경
명령어
설명
/config
설정 메뉴 열기 (테마, 모델 등)
/model
사용할 Claude 모델 변경
/permissions
도구 권한 설정 (allow/deny)
/login / /logout
인증 관리
/add-dir
작업 가능 디렉토리 추가
/memory
CLAUDE.md 메모리 파일 편집
/vim
Vim 키바인딩 모드 토글
프로젝트 초기화
명령어
설명
/init
CLAUDE.md 자동 생성 (코드베이스 분석)
/agents
서브에이전트 관리 (생성/수정/조회)
/hooks
훅(Hook) 관리
/mcp
MCP 서버 연결 관리
코드 작업
명령어
설명
/review
현재 브랜치 또는 PR 코드 리뷰
/security-review
보안 취약점 검토
/pr_comments
PR 코멘트 조회
/bug
버그 리포트 제출
참고: 설치된 플러그인이나 사용자 정의 명령어는
/입력 시 자동 표시됩니다.
기본 단축키
단축키
동작
Ctrl+C
현재 작업 취소 / 종료
Ctrl+D
Claude Code 종료
Ctrl+L
화면 지우기
Ctrl+R
명령 히스토리 검색
Esc
진행 중인 작업 중단
Esc 2회
이전 메시지로 점프 (편집 가능)
Shift+Tab
모드 순환 전환 (Default → Auto-accept → Plan)
↑ / ↓
이전 입력 히스토리 탐색
Tab
자동 완성 (파일 경로, 명령어)
\ + Enter
줄바꿈 (메시지 내)
Alt+Enter
줄바꿈 (일부 터미널)
다중 줄 입력
"""(트리플 쿼트) 또는\+ Enter로 여러 줄 입력이미지는 드래그앤드롭 또는 클립보드 붙여넣기 (Ctrl+V)
모드 전환
Shift+Tab을 누르면 순차적으로 모드가 변경됩니다:
Default Mode — 매 도구 호출마다 확인
Auto-accept Mode — 파일 편집 자동 수락
Plan Mode — 읽기 전용, 실행 전 계획 수립
Default Mode (기본)
파일 편집, 셸 명령 등 모든 도구 사용 시 사용자 승인 필요
안전하지만 상호작용이 많음
Auto-accept Mode (자동 수락)
파일 편집 자동 수락
빠른 반복 작업에 적합
위험한 명령(rm, git push 등)은 여전히 확인
Plan Mode (계획 모드)
읽기 전용 모드
파일 수정/실행 없이 분석 및 계획만 수립
ExitPlanMode로 계획 승인 후 실행 시작대규모 변경 전 권장
# Plan Mode 진입
Shift+Tab을 눌러 "Plan mode"로 전환
# 작업 지시
"인증 시스템을 OAuth로 마이그레이션할 계획 세워줘"
# Claude가 계획 제시 → 승인 → 실행
VS Code / Cursor
Marketplace에서 "Claude Code" 확장 설치
Cmd/Ctrl+Esc로 패널 열기에디터의 선택 영역, 진단 정보를 자동 컨텍스트로 사용
JetBrains (IntelliJ, PyCharm 등)
Plugins → "Claude Code" 설치
우측 사이드바에서 활성화
주요 IDE 기능
선택한 코드 자동 첨부 (
@selection)에러/경고 자동 감지 (
mcp__ide__getDiagnostics)Jupyter 노트북 셀 실행 (
mcp__ide__executeCode)
워크플로우 1: 새 기능 추가
1. /init # 처음이면 CLAUDE.md 생성
2. Shift+Tab → Plan Mode
3. "사용자 인증 기능을 JWT로 추가해줘"
4. 계획 검토 → 승인
5. Shift+Tab → Auto-accept Mode
6. 실행 자동 진행
7. ! npm test # 직접 테스트
8. "커밋 메시지 작성하고 커밋해줘"
워크플로우 2: 코드 리뷰
1. git checkout feature-branch
2. claude
3. /review # 전체 변경 리뷰
4. /security-review # 보안 검토
워크플로우 3: 디버깅
1. @logs/error.log @src/api/handler.ts
2. "이 에러의 원인 찾아줘"
3. ! npm run debug # 디버그 모드 실행
4. Claude가 로그 분석 후 수정 제안
워크플로우 4: 대규모 리팩터링
1. Plan Mode 진입
2. "전역 상태관리를 Redux에서 Zustand로 마이그레이션 계획 세워줘"
3. 단계별 계획 검토
4. 각 단계마다 분리 실행 (한 번에 다 하지 말 것)
5. 단계별 git commit
컨텍스트가 너무 길어졌을 때
/compact # 요약 후 계속
/clear # 완전 초기화 (새 작업 시작 시)
Claude가 의도와 다르게 동작할 때
Esc Esc # 이전 메시지로 돌아가서 수정
# 잘못된 동작이 반복되면 → 명확하게 설명 추가
권한 프롬프트가 너무 많을 때
/permissions # 자주 쓰는 명령 allowlist 추가
또는 /fewer-permission-prompts 스킬 실행
비용이 걱정될 때
/cost # 실시간 사용량 확인
/model # Haiku 등 저렴한 모델로 전환
/compact # 컨텍스트 줄이기
세션을 잃어버렸을 때
claude --resume # 또는 /resume
1. 파일 참조는 @로
@src/**/*.ts # 글롭 패턴 가능
@README.md @CHANGELOG.md # 여러 파일 동시
2. 셸 출력을 컨텍스트에 넣기
! curl -s https://api.example.com/data | jq .
3. 이미지 분석
스크린샷이나 다이어그램을 드래그앤드롭하면 Claude가 시각적으로 분석합니다.
4. 멀티 에이전트 협업
# 여러 서브에이전트를 병렬 호출하여 빠른 분석
"code-reviewer와 security-reviewer를 병렬로 돌려줘"
5. CLAUDE.md를 짧고 명확하게
200줄 이상이면 컨텍스트 낭비
코드베이스에서 추론 가능한 내용은 제외
"왜(Why)" 위주로 작성
참고 링크
모델 비교: Opus 4.7 (최고 성능) / Sonnet 4.6 (균형) / Haiku 4.5 (빠름·저렴)
Made with Claude Code | 2026-05-18
태그: #문서자동화