​
시작하기

Claude Code는 상호작용할 수 있는 두 가지 주요 방법을 제공합니다:
  • 대화형 모드: claude를 실행하여 REPL 세션 시작
  • 일회성 모드: 빠른 명령을 위해 claude -p "쿼리"를 사용
# 대화형 모드 시작
claude

# 초기 쿼리로 시작
claude "이 프로젝트 설명해줘"

# 단일 명령 실행 후 종료
claude -p "이 함수는 무엇을 하나요?"

# 파이프된 콘텐츠 처리
cat logs.txt | claude -p "이 오류들을 분석해줘"

​
CLI 명령어

명령어설명예시
claude대화형 REPL 시작claude
claude "쿼리"초기 프롬프트로 REPL 시작claude "이 프로젝트 설명해줘"
claude -p "쿼리"일회성 쿼리 실행 후 종료claude -p "이 함수 설명해줘"
cat file | claude -p "쿼리"파이프된 콘텐츠 처리cat logs.txt | claude -p "설명해줘"
claude -c가장 최근 대화 계속하기claude -c
claude -c -p "쿼리"출력 모드로 계속하기claude -c -p "타입 오류 확인해줘"
claude -r "<session-id>" "쿼리"ID로 세션 재개claude -r "abc123" "이 PR 완성해줘"
claude update최신 버전으로 업데이트claude update
claude mcpModel Context Protocol 서버 구성튜토리얼의 MCP 섹션 참조

​
CLI 플래그

다음 명령줄 플래그로 Claude Code의 동작을 사용자 지정할 수 있습니다:
플래그설명예시
--add-dirClaude가 접근할 수 있는 추가 작업 디렉토리 추가(각 경로가 디렉토리로 존재하는지 검증)claude --add-dir ../apps ../lib
--allowedToolssettings.json 파일 외에도 사용자 허가 없이 허용되어야 하는 도구 목록"Bash(git log:*)" "Bash(git diff:*)" "Write"
--disallowedToolssettings.json 파일 외에도 사용자 허가 없이 거부되어야 하는 도구 목록"Bash(git log:*)" "Bash(git diff:*)" "Write"
--print, -p대화형 모드 없이 응답 출력(프로그래밍 방식 사용에 대한 자세한 내용은 SDK 문서 참조)claude -p "쿼리"
--output-format출력 모드의 출력 형식 지정(옵션: text, json, stream-json)claude -p "쿼리" --output-format json
--verbose상세 로깅 활성화, 전체 턴별 출력 표시(출력 및 대화형 모드 모두에서 디버깅에 유용)claude --verbose
--max-turns비대화형 모드에서 에이전트 턴 수 제한claude -p --max-turns 3 "쿼리"
--model최신 모델의 별칭(sonnet 또는 opus) 또는 모델의 전체 이름으로 현재 세션의 모델 설정claude --model claude-sonnet-4-20250514
--permission-prompt-tool비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구 지정claude -p --permission-prompt-tool mcp_auth_tool "쿼리"
--resumeID로 특정 세션을 재개하거나 대화형 모드에서 선택claude --resume abc123 "쿼리"
--continue현재 디렉토리에서 가장 최근 대화 불러오기claude --continue
--dangerously-skip-permissions권한 프롬프트 건너뛰기(주의해서 사용)claude --dangerously-skip-permissions
--output-format json 플래그는 특히 스크립팅 및 자동화에 유용하며, Claude의 응답을 프로그래밍 방식으로 파싱할 수 있습니다.
출력 형식, 스트리밍, 상세 로깅 및 프로그래밍 방식 사용을 포함한 출력 모드(-p)에 대한 자세한 정보는 SDK 문서를 참조하세요.

​
슬래시 명령어

대화형 세션 중 Claude의 동작을 제어합니다:
명령어목적
/bug버그 보고(대화를 Anthropic에 전송)
/clear대화 기록 지우기
/compact [instructions]선택적 집중 지침으로 대화 압축
/config구성 보기/수정
/cost토큰 사용 통계 표시
/doctorClaude Code 설치 상태 확인
/help사용법 도움말 보기
/initCLAUDE.md 가이드로 프로젝트 초기화
/loginAnthropic 계정 전환
/logoutAnthropic 계정에서 로그아웃
/memoryCLAUDE.md 메모리 파일 편집
/modelAI 모델 선택 또는 변경
/permissions권한 보기 또는 업데이트
/pr_comments풀 리퀘스트 댓글 보기
/review코드 리뷰 요청
/status계정 및 시스템 상태 보기
/terminal-setup줄바꿈을 위한 Shift+Enter 키 바인딩 설치(iTerm2 및 VSCode만 해당)
/vim삽입 모드와 명령 모드를 번갈아 사용하는 vim 모드 진입

​
특수 단축키

​
#로 빠른 메모리

입력을 #으로 시작하여 즉시 메모리 추가: 
# 항상 설명적인 변수 이름 사용하기
이를 저장할 메모리 파일을 선택하라는 메시지가 표시됩니다.

​
터미널에서 줄 바꿈

다음을 사용하여 여러 줄 명령 입력:
  • 빠른 이스케이프: \ 입력 후 Enter
  • 키보드 단축키: Option+Enter(또는 구성된 경우 Shift+Enter)
터미널에서 Option+Enter 설정 방법: Mac Terminal.app의 경우:
  1. 설정 → 프로필 → 키보드 열기
  2. “Option을 Meta 키로 사용” 체크
iTerm2 및 VSCode 터미널의 경우:
  1. 설정 → 프로필 → 키 열기
  2. 일반에서 왼쪽/오른쪽 Option 키를 “Esc+“로 설정
iTerm2 및 VSCode 사용자를 위한 팁: Claude Code 내에서 /terminal-setup을 실행하여 더 직관적인 대안으로 Shift+Enter를 자동으로 구성하세요. 구성 세부 정보는 설정의 터미널 설정을 참조하세요.

​
Vim 모드

Claude Code는 /vim 또는 /config를 통해 활성화할 수 있는 Vim 키 바인딩의 하위 집합을 지원합니다. 지원되는 하위 집합에는 다음이 포함됩니다:
  • 모드 전환: Esc(NORMAL로), i/I, a/A, o/O(INSERT로)
  • 탐색: h/j/k/l, w/e/b, 0/$/^, gg/G
  • 편집: x, dw/de/db/dd/D, cw/ce/cb/cc/C, .(반복)