강의모드 종료
← course overview
chapter 03lesson 3.2publicworkbench

Claude Code 기본기 쌓기

Claude Code 기본 사용법 익히기

Claude 기본 사용법

얻어갈 것

  • Claude Code의 기본 설정과 사용법에 대해 익힙니다.

처음 확인할 설정

  • /login으로 계정 연결 상태를 확인합니다.
  • /model은 어떤 Claude 모델로 작업할지 고르는 메뉴입니다. 기본적으로 Opus 모델을 사용하는 걸 추천합니다 (Haiku, Sonnet, Opus순으로 모델의 성능이 좋습니다)
  • /effort는 Claude가 얼마나 깊게 생각할지 조절하는 설정입니다. 처음에는 기본값으로 두고, 어려운 문제에서만 올립니다.
  • /config는 테마, 자동 compact, 권한 같은 환경 설정을 확인하는 곳입니다.

입력창 기본기

  • ctrl + Enter(mac Option + Enter) 는 줄바꿈, Esc 두 번은 입력창 비우기입니다.
  • Alt + 화살표(mac: Option + 화살표)는 단어 단위로 커서를 이동할 때 씁니다.
  • Alt + Delete(mac: Option + Delete)는 단어 단위로 지울 때 편합니다.
  • 작업이 길어지거나 잘못 가고 있으면 Esc로 현재 응답을 중단합니다.
  • Ctrl + C를 두 번 누르면 현재 Claude Code 세션을 종료합니다.

파일과 폴더를 가리키기

  • @로 파일이나 폴더를 멘션하면 Claude Code가 봐야 할 대상을 좁힐 수 있습니다.
  • 파일을 직접 드래그해도 맥락을 전달할 수 있습니다.
  • 이미지는 클립보드에 복사한 뒤 붙여넣어 전달할 수 있습니다. mac에서는 보통 Cmd + V, Windows/Linux에서는 Ctrl + V 흐름으로 이해하면 됩니다. (보통 스크린샷을 찍고 공유할 때도 많이 사용합니다)

슬래시 명령어

컨텍스트 관리

  • /clear는 대화 맥락을 새로 시작하고 싶을 때 씁니다.
  • /compact는 대화가 길어졌지만 이어서 작업하고 싶을 때 씁니다.

둘은 비슷해 보여도 목적이 다릅니다.

  • 앞 대화가 오히려 방해된다면 /clear로 끊습니다.
  • 같은 작업을 계속하지만 대화가 너무 길어졌다면 /compact로 줄입니다.
  • 새 기능을 시작할 때는 /clear, 같은 버그를 계속 추적할 때는 /compact 쪽이 자연스럽습니다.

기타

  • /usage는 구독 플랜의 사용량과 제한 상태를 볼 때 씁니다.
  • /status는 현재 계정, 모델, 연결 상태를 빠르게 확인할 때 씁니다.
  • /skills는 사용할 수 있는 Skill을 확인할 때 씁니다.

모드 전환

  • Shift + Tab으로 권한 모드를 바꿉니다. 기본 순환은 defaultacceptEditsplan -> auto입니다.
  • 모드는 에이전트가 얼마나 직접 실행하고 물어볼지에 대한 안전장치로 이해하면 됩니다.

자주 보는 모드는 이렇게 이해하면 됩니다.

모드동작
default파일 수정·명령 실행 전에 매번 물어봅니다. 처음엔 가장 안전합니다.
acceptEdits작업 폴더 안 파일 수정은 자동, 위험·범위 밖 명령은 확인합니다.
plan바로 안 고치고 먼저 읽고 계획을 세웁니다. 큰 수정·낯선 코드에 좋습니다.
autoClaude가 안전하다고 본 작업은 덜 묻고 진행합니다.
bypassPermissions모든 확인을 건너뜁니다. 개인 프로젝트에서 빠르게 갈 때.

statusline 설정하기

statusline은 Claude Code 화면 아래에 계속 보이는 작은 상태 영역입니다. 긴 작업을 할 때는 "지금 어느 폴더에서, 어떤 모델로, 얼마나 많은 맥락을 쓰고 있는지"를 매번 명령어로 확인하지 않아도 됩니다.

처음에는 복잡하게 꾸미기보다 아래 세 가지만 보이게 해도 충분합니다.

  • 현재 디렉토리: Claude Code가 어느 프로젝트 폴더를 기준으로 작업 중인지 확인합니다.
  • 선택된 모델: 지금 Opus, Sonnet, Haiku 중 무엇을 쓰고 있는지 봅니다.
  • 컨텍스트 사용률: 대화가 얼마나 길어졌는지 보고 /compact 시점을 판단합니다.
statusline은 작업 중 계속 보는 계기판에 가깝습니다. 폴더, 모델, 컨텍스트 사용률처럼 자주 확인하는 정보를 아래에 고정해둡니다.

Claude Code 안에서 /statusline을 입력하고 원하는 모양을 자연어로 말하면 설정을 만들어줍니다. 아래 P1 프롬프트처럼 짧게 요청해보세요.

P1statusline 만들기
/statusline 현재 디렉토리와 선택된 모델 이름과 컨텍스트 사용율을 프로그레스바로 보여줘

실습하기: 회의록 정리하기

먼저 오른쪽 workbench에서 meetings.zip을 내려받아 연습용 폴더에 풀어두세요.

연습 폴더 열기
cd ~/projects/cc-practice  # 연습용 폴더 들어가기
// meetings.zip을 압축해제 해둡니다
claude  # 이 폴더에서 Claude Code 시작

그 다음 VS Code의 터미널 환경에서 줄바꿈이 잘 될 수 있도록 /terminal-setup을 해줍니다.

이후 Claude Code를 다시 열고 P2 프롬프트처럼 @meetings 폴더를 멘션해서 회의록을 한꺼번에 읽게 합니다.

P2회의록 정리하기
@meetings 를 읽고 회의 내용을 업무 관점에서 정리해줘.

- 결정된 것
- 해야 할 일
- 아직 정해지지 않은 것

마무리

  • Claude Code 기본 커맨드들을 바탕으로 앞으로 사용하면서 자연스럽게 능숙해질 겁니다.
  • 다음 레슨에서는 반복되는 워크플로우를 저장해두는 Skill을 살펴봅니다.