CLI 참조 (CLI Reference)
읽는 시간: 20분 | 난이도: 초급자
Claude Code의 모든 CLI 명령어, 옵션, 그리고 사용법에 대한 완전한 참조 가이드입니다.
개요
이 가이드는 Claude Code CLI의 모든 명령어와 옵션을 포괄적으로 다룹니다. 빠른 참조를 위한 구조화된 형식으로 제공됩니다.
1. 기본 명령어 (Basic Commands)
1.1 시작 및 도움말
# Claude Code 시작
claude [options]
# 도움말 표시
claude --help
claude -h
# 버전 확인
claude --version
claude -v
# 상세 정보 표시
claude --verbose
1.2 대화형 모드
# 대화형 모드 시작
claude
# 특정 프로젝트에서 시작
claude --path /path/to/project
# 특정 프로필로 시작
claude --profile development
# 비대화형 모드
claude --non-interactive
2. 파일 명령어 (File Commands)
2.1 파일 읽기
# 파일 읽기
claude read <file>
claude cat <file>
# 여러 파일 읽기
claude read <file1> <file2> <file3>
# 파일 내용 검색
claude grep <pattern> <file>
claude grep -r <pattern> <directory>
# 정규식 검색
claude grep -E "^[A-Z]" <file>
2.2 파일 쓰기
# 파일 생성
claude write <file> <content>
# 파일 수정
claude edit <file> --pattern <old> --replacement <new>
# 파일 복사
claude copy <source> <destination>
# 파일 이동
claude move <source> <destination>
# 파일 삭제
claude remove <file>
claude rm <file>
2.3 파일 검색
# 파일 검색
claude find <pattern>
claude find --name "*.js"
claude find --type directory
# Glob 패턴 검색
claude glob "**/*.ts"
claude glob "src/**/*.{js,ts}"
3. Git 명령어 (Git Commands)
3.1 커밋
# 상태 확인
claude git status
# 변경사항 확인
claude git diff
# 커밋 생성
claude git commit <message>
claude git commit --amend
# 스테이징
claude git add <file>
claude git add .
# 커밋 취소
claude git reset
claude git reset --hard
3.2 브랜치
# 브랜치 목록
claude git branch
# 브랜치 생성
claude git branch <branch-name>
# 브랜치 전환
claude git checkout <branch-name>
# 브랜치 삭제
claude git branch -d <branch-name>
3.3 푸시/풀
# 풀
claude git pull
# 푸시
claude git push
# 원격 브랜치 푸시
claude git push -u origin <branch>
# 테그 푸시
claude git push --tags
4. 테스트 및 빌드 (Test & Build)
4.1 테스트
# 모든 테스트 실행
claude test
# 특정 테스트 파일
claude test <test-file>
# 감시 모드
claude test --watch
# 커버리지
claude test --coverage
# 디버그 모드
claude test --debug
4.2 빌드
# 프로젝트 빌드
claude build
# 프로덕션 빌드
claude build --production
# 감시 빌드
claude build --watch
# 빌드 분석
claude build --analyze
4.3 Lint
# Lint 실행
claude lint
# 자동 수정
claude lint --fix
# 특정 파일
claude lint <file>
# 규칙 확인
claude lint --rules
5. 프로젝트 명령어 (Project Commands)
5.1 초기화
# 새 프로젝트 초기화
claude init <project-type>
# 지원되는 프로젝트 타입
claude init --list
# 특정 템플릿 사용
claude init --template <template-name>
# 대화형 초기화
claude init --interactive
5.2 설정
# 설정 확인
claude config list
# 설정 가져오기
claude config get <key>
# 설정 설정
claude config set <key> <value>
# 설정 삭제
claude config unset <key>
# 설정 재설정
claude config reset
6. 스킬 명령어 (Skill Commands)
6.1 스킬 관리
# 스킬 목록
claude skill list
# 스킬 실행
claude skill run <skill-name> [args]
# 스킬 정보
claude skill info <skill-name>
# 스킬 생성
claude skill create <skill-name>
# 스킬 삭제
claude skill delete <skill-name>
6.2 스킬 개발
# 스킬 편집
claude skill edit <skill-name>
# 스킬 테스트
claude skill test <skill-name>
# 스킬 배포
claude skill publish <skill-name>
# 스킬 업데이트
claude skill update <skill-name>
7. 플러그인 명령어 (Plugin Commands)
7.1 플러그인 관리
# 플러그인 설치
claude plugin install <plugin-name>
# 플러그인 목록
claude plugin list
# 플러그인 정보
claude plugin info <plugin-name>
# 플러그인 업데이트
claude plugin update <plugin-name>
claude plugin update --all
# 플러그인 제거
claude plugin uninstall <plugin-name>
7.2 플러그인 개발
# 플러그인 생성
claude plugin create <plugin-name>
# 플러그인 빌드
claude plugin build <plugin-name>
# 플러그인 테스트
claude plugin test <plugin-name>
8. 메모리 명령어 (Memory Commands)
8.1 세션 관리
# 세션 목록
claude session list
# 세션 복원
claude session restore <session-id>
# 세션 내보내기
claude session export <session-id> --format json
# 세션 삭제
claude session delete <session-id>
8.2 메모리 관리
# 메모리 상태
claude memory stats
# 메모리 정리
claude memory cleanup --sessions --older-than 30d
claude memory cleanup --cache
claude memory cleanup --all
9. 고급 명령어 (Advanced Commands)
9.1 디버깅
# 디버그 모드
claude --debug
# 상세 로그
claude --verbose --log-level debug
# 로그 파일
claude --log-file /path/to/log.txt
# 추적 모드
claude --trace
9.2 프로필링
# 프로필링 활성화
claude --profile
# 성능 보고서
claude --profile --report
# 메모리 프로필링
claude --profile --memory
9.3 비교 및 분석
# 파일 비교
claude diff <file1> <file2>
# 코드 분석
claude analyze <file>
# 복잡도 분석
claude complexity <file>
# 의존성 분석
claude dependencies
10. 옵션 (Options)
10.1 전역 옵션
# 도움말
--help, -h
# 버전
--version, -v
# 상세 출력
--verbose, -v
# quiet 모드
--quiet, -q
# 비대화형
--non-interactive
# 설정 파일
--config <path>
# 프로필
--profile <name>
10.2 작업 디렉터리
# 작업 디렉터리 설정
--cwd, --directory <path>
# 프로젝트 경로
--project <path>
10.3 출력 옵션
# JSON 출력
--json
# Markdown 출력
--markdown
# 색상 없음
--no-color
# 테이블 형식
--table
요약
이 CLI 참조 가이드는 Claude Code의 모든 명령어와 옵션을 포괄적으로 다룹니다.
명령어 카테고리
- 기본 명령어: 시작, 도움말
- 파일 명령어: 읽기, 쓰기, 검색
- Git 명령어: 버전 관리
- 테스트 및 빌드: 테스트, 빌드, lint
- 프로젝트 명령어: 초기화, 설정
- 스킬 명령어: 스킬 관리
- 플러그인 명령어: 플러그인 관리
- 메모리 명령어: 세션 및 메모리
- 고급 명령어: 디버깅, 프로필링
- 옵션: 전역, 출력, 설정
빠른 참조
# 도움말
claude --help
claude <command> --help
# 명령어 완성
claude <command> --completion
# 매뉴얼 페이지
man claude
다음 단계
- Troubleshooting - 문제 해결
이 가이드가 도움이 되셨나요?
CLI 사용에 대한 추가 질문이 있으시면 언제든지 물어보세요!