기본 조작과 명령어

Claude Code 의 기본 조작은 터미널에서 치는 셸 명령(claude, claude -c, claude -p)과 대화 모드 안에서 쓰는 슬래시 명령(/clear, /help, /resume) 두 종류로 나뉩니다. 전부 외울 필요는 없습니다. claude 로 실행, Ctrl+D 로 종료, claude -c 로 이어가기 세 가지만 알아도 일상 작업은 충분히 돌아가고, 나머지는 필요할 때 하나씩 익히면 됩니다.

핵심 요약

• 실행은 claude, 종료는 Ctrl+D 또는 Ctrl+C 입니다.
• 직전 대화는 claude -c, 과거 대화 목록은 claude -r 로 재개합니다.
• 대화 모드 안에서는 /clear, /help, /resume 같은 슬래시 명령을 씁니다.
• 파일은 @경로 로 지목하고, 잘못 가고 있으면 Esc 로 바로 멈춥니다.
• 승인 요청의 "항상"은 읽기 전용 작업에만 쓰는 편이 안전합니다.

셸 명령과 슬래시 명령은 무엇이 다른가

처음에는 차이가 헷갈리지만, "Claude Code 를 켜기 전이면 셸 명령, 켠 뒤면 슬래시 명령"으로 기억하면 됩니다. 세션을 처음 열어 보는 과정은 첫 세션 실전에서 따라 할 수 있습니다.

세션 시작과 종료

가장 기본이 되는 명령은 claude 입니다. 프로젝트 루트 디렉터리로 이동한 뒤 실행합니다.

cd ~/Desktop/test-project
claude

실행하면 세션 정보와 최근 대화 이력이 표시되고, 여기서부터 대화 형식으로 작업을 시작합니다. 초기 지시를 함께 넘기고 싶으면 claude "fix the build error" 처럼 문자열을 붙여 실행할 수도 있습니다.

종료는 Ctrl+D 또는 Ctrl+C 입니다. Ctrl+D 는 확인이 뜨면 한 번 더 누르고, Ctrl+C 는 입력란이 빈 상태에서 두 번 연속 누릅니다. 결과는 같으니 손에 익는 쪽을 쓰면 됩니다. 대화 모드 안에서 /exit 를 쳐도 종료됩니다.

대화 모드 없이 한 번만 실행하려면

대화 모드에 들어가지 않고 일회성 작업만 시키고 싶을 때는 -p 옵션을 씁니다. 결과를 출력한 뒤 바로 종료되므로 스크립트에서 호출하거나 파이프로 연결하기 좋습니다.

claude -p "README.md를 읽고 개요를 설명해줘"

자동화에 활용하는 방법은 비대화 모드(-p)에서 자세히 다룹니다.

이전 대화를 이어가려면

Claude Code 는 대화 이력을 로컬에 저장하므로 중단한 작업을 다시 이어갈 수 있습니다. claude 로 새 세션을 열면 이전 컨텍스트가 사라지니, 같은 작업을 계속할 때는 의식적으로 -c 를 붙이는 습관을 들이는 편이 좋습니다.

claude -c   # 직전 대화 이어가기
claude -r   # 과거 대화 목록에서 골라 재개

claude -r 을 실행하면 이런 목록이 뜹니다.

Resume
❯ README.md를 읽고 개요를 설명해줘
  14 seconds ago · 4 messages · main
↓ 테스트 에러를 수정해줘
  1 minute ago · 2 messages · main

오래된 대화는 컨텍스트가 일부 사라진 경우도 있으니 유의하세요. 대화 모드 안에서는 /resume 이 같은 역할을 하며, "아까 그 다른 프로젝트 대화로 돌아가고 싶다"는 상황에 편리합니다. 세션의 저장·재개 원리는 세션 관리 — 시작·종료·재개에서 다룹니다.

자주 쓰는 슬래시 명령

/ 를 치면 후보 목록이 뜨고, 도중까지 입력하면 후보가 좁혀집니다.

> /cl
  /clear     Start a new session with empty context; previous session stays on disk
  /compact   Free up context by summarizing the conversation so far

/help 는 명령을 잊었을 때 가장 먼저 칠 명령입니다. /init 으로 만드는 지침 파일은 CLAUDE.md 작성법에서, 모델 전환은 모델 고르기와 /model 전환에서 이어집니다.

/clear 는 무엇을 지우나

/clear 는 현재 컨텍스트, 쉽게 말해 "지금까지의 대화 내용"을 비우고 새 세션을 시작합니다. 새 주제를 시작할 때나 이전 화제를 끌고 와서 엉뚱한 답이 돌아올 때 쓰면 해결되는 경우가 많습니다.

> /clear

지워진 세션은 디스크에 그대로 남아 /resume 으로 돌아갈 수 있습니다. 대화를 통째로 비우는 대신 요약해서 줄이는 /compact 와의 사용 구분은 컨텍스트 윈도우 관리에서, 대화를 특정 시점으로 되감는 /rewind 는 /rewind 로 되감기에서 다룹니다.

파일을 정확히 지목하려면

@ 뒤에 경로나 파일명을 붙이면 파일을 직접 가리킬 수 있습니다.

> @src/utils/date.ts 이 파일의 시간대 처리가 맞는지 봐줘.

이렇게 하면 Claude 가 파일을 찾느라 헤매지 않습니다. 같은 이름의 파일이 여러 개면 입력 후보가 표시됩니다. 어디를 봐야 할지 아는 상황이면 항상 지목하세요.

작업을 중단하고 방향을 바꾸려면

작업 도중 방향이 틀렸다고 느끼면 Esc 를 눌러 멈춥니다. 그리고 바로 정정합니다.

> 잠깐, 그 파일은 건드리지 마. 대신 설정 파일 쪽을 봐줘.

잘못된 방향으로 오래 가게 두지 마세요. 즉시 잡는 것이 나중에 되돌리는 것보다 훨씬 쌉니다. 입력 도중 Ctrl+C 를 한 번 누르면 종료가 아니라 입력 취소가 되니, 쓰다 만 지시를 버릴 때도 쓸 수 있습니다.

여러 줄로 지시를 쓰려면

긴 지시를 줄바꿈해서 쓰려면 줄 끝에 \ 를 넣거나 Shift+Enter 를 사용합니다.

> 다음 세 가지를 순서대로 해줘:
  1. 실패하는 테스트를 먼저 실행해서 오류를 확인
  2. 원인을 설명
  3. 수정 후 다시 테스트

승인 요청은 어떻게 다루나

파일 수정이나 명령 실행 전에 확인 창이 뜹니다. 선택지는 대체로 세 가지입니다.

• 예 — 이번만 승인합니다.
• 항상 — 같은 종류의 작업을 이후 자동 승인합니다.
• 아니오 — 거부하고 다른 방법을 요구합니다.

"항상"은 편하지만 신중하게 쓰세요. 읽기 전용 작업에만 적용하는 것을 권합니다. Shift+Tab 으로 기본 모드·자동 승인(accept edits)·계획 모드(plan mode)를 순환하는 방법은 첫 세션 실전에, 자동 승인 범위를 세밀하게 정하는 방법은 퍼미션 설정 최적화에 있습니다.

키보드 단축키

특히 Tab 자동완성은 적극 쓰는 걸 권합니다. 명령을 도중까지 치고 Tab 을 누르면 완성되므로 입력 실수도 줄어듭니다.

명령어 일람표

작업 이력 되돌리기

Git 을 쓰고 있다면 언제든 되돌릴 수 있습니다.

git diff          # 뭐가 바뀌었는지 확인
git checkout .    # 전부 되돌리기

작업 전에 커밋해 두는 습관을 들이면 마음 편히 시킬 수 있습니다. 대화 모드 안에서 "커밋해줘"라고 부탁하면 커밋 메시지까지 만들어 주는데, 이 흐름은 Git 조작 자동화에서 이어집니다.

연습 문제

1. /init 을 실행해 CLAUDE.md 가 만들어지는지 확인하세요.
2. @ 로 특정 파일을 지목해 설명을 요청해 보세요.
3. 작업 중간에 Esc 로 멈추고 방향을 바꿔 보세요.
4. Ctrl+D 로 종료한 뒤 claude -c 로 같은 대화를 이어가 보세요.

정리

• 셸 명령(claude, -c, -r, -p)은 터미널에서, 슬래시 명령(/clear, /help, /resume)은 대화 모드 안에서 씁니다.
• 먼저 claude, Ctrl+D, claude -c 세 가지만 익히고 나머지는 필요할 때 /help 로 찾으세요.
• @경로 로 파일을 지목하고, 방향이 틀리면 Esc 로 즉시 멈춥니다.
• 승인 요청의 "항상"은 읽기 전용 작업에만, 작업 전 커밋으로 되돌릴 지점을 만들어 두세요.
• 다음 단계는 파일 조작 배우기이며, 정형 작업을 자동화하려면 커스텀 커맨드 입문으로 이어집니다.