Claude CLI 입문 대시보드

Cursor IDE 내장 터미널에서 구동되는 Claude CLI의 핵심 규칙과 필수 명령어를 인터랙티브하게 학습해 보세요.

1. 프로젝트의 나침반: CLAUDE.md 설정

프로젝트 최상위 경로에 위치하여 Claude에게 프로젝트의 기본 규칙을 알려주는 필수 지침서입니다. 올바른 경로에서 실행하는 것이 매우 중요합니다.

생성 방법 터미널에서 명령어 입력 또는 직접 파일 생성

# 1. 프로젝트 최상위(Root) 폴더인지 확인 후
user@workspace~/project$ /init
💡 직접 CLAUDE.md 파일을 생성해도 됩니다.

[실무 팁] 파일 길이는 300자 이내로 유지하세요. 프로젝트가 크다면 /api, /web 등 각 하위 폴더별로 CLAUDE.md를 따로 만들어 관리하는 것이 토큰 소모를 막고 성능을 높이는 지름길입니다.

CLAUDE.md 작성 3대 원칙 (클릭하여 확인)

원칙 1

최소한의 필수 정보만

전체 구조 대신 꼭 필요한 컨벤션만 명시.

원칙 2

정기적인 정리 (Cleanup)

작업이 끝난 임시 규칙은 지우기.

원칙 3

스킬 및 문서 분리

상세 문서는 별도 파일로 분리.

2. 생존 필수 명령어 터미널 시뮬레이터

명령어를 직접 클릭하여 가상의 터미널에서 어떤 결과와 설명이 나타나는지 확인해 보세요.

Cursor Integrated Terminal
user@workspace~/project$ claude
Welcome to Claude CLI. Type /help for commands.
>

3. 대화 초기화의 중요성 (Data 비교)

왜 가급적 하나의 기능 구현이 끝날 때마다 /clear를 무조건 사용해야 할까요? 대화가 길어질수록 발생하는 토큰(비용)의 기하급수적 증가를 아래 차트에서 직접 비교해 보세요.

🚨 /clear 미사용

과거 대화 기록이 계속 누적되어, 한 번 질문할 때마다 소모되는 토큰(비용)이 눈덩이처럼 불어납니다. AI의 혼란(할루시네이션)도 증가합니다.

기능별 /clear 사용

컨텍스트가 초기화되어 비용이 최소화되며, AI가 백지상태에서 새로운 기능에만 온전히 집중할 수 있어 코드의 정확도가 올라갑니다.

4. 실무 생산성 200% 상승: 핵심 단축키 & 명령어

입문자가 가장 먼저 손에 익혀야 할 핵심 제어 수단 3가지입니다.

Shift + Tab

플랜 모드 (Plan Mode)

코드를 즉시 생성하지 않고, AI가 "어떻게 구현할 것인가"에 대한 계획을 먼저 제시하도록 합니다. 불필요한 코드 생성을 막아 토큰 낭비를 차단합니다.

💡 사용법:

명령어 입력 후 Enter 대신 Shift + Tab을 누릅니다. 제시된 계획을 검토한 후 수락(Enter)하거나 취소(ESC)하세요.

ESC

중단 및 되감기

AI가 엉뚱한 방향으로 코드를 짜거나 멈춰있을 때 제어권을 즉시 가져옵니다.

💡 1번 누르기 (Interrupt):

작업 중인 AI를 즉시 중단시킵니다.

💡 2번 누르기 (Rewind):

입력창이 비어있을 때 누르면 이전 명령 시점으로 시간을 되돌립니다.

btw

가벼운 지시 추가

"By the way(그런데 말이야)"의 약자로, 현재 맥락을 끊지 않고 부가적인 미세 조정(Pivot)을 지시합니다.

💡 사용법:

> btw 버튼 색상은 파란색으로 해줘

전체 프롬프트를 다시 작성할 필요 없이 즉각적인 수정 사항만 가볍게 전달합니다.

📊 btw 명령어의 압도적인 토큰 절약 효과

기존 방식처럼 "버튼 색상을 파란색으로 바꾼 코드를 다시 짜줘"라고 새로운 프롬프트를 작성하면, AI는 전체 파일 컨텍스트를 다시 읽어들여 엄청난 토큰을 소모합니다.

반면, btw 명령어를 사용하면 현재 컨텍스트 위에 '변경 사항'만 덧씌우므로 소모 토큰을 1/10 수준으로 줄일 수 있습니다. 빠른 미세 조정에 필수적입니다.

5. 상황별 모델 선택 및 opusplan 모드

AI 모델은 각자 장단점이 있습니다. 작업의 난이도에 맞게 두뇌를 교체하세요.

🧠 Opus
가장 똑똑함 / 비용 높음
  • 복잡한 아키텍처 및 로직 설계
  • 어려운 버그 원인 분석
  • 추천: 초기 계획(Plan) 수립
⚡ Sonnet
뛰어난 코딩 속도 / 균형
  • 실제 코드 작성 및 수정
  • 리팩토링 및 기능 추가
  • 추천: 실전 코딩 작업
💨 Haiku
가장 빠름 / 비용 저렴
  • 단순 반복 스크립트 작성
  • 문서 오타 수정, 단순 요약
  • 추천: 단순/대량 작업

🚀 궁극의 자동화: opusplan 모드

최고의 효율을 내려면 설계는 똑똑한 Opus로, 실제 코딩은 빠르고 가성비 좋은 Sonnet으로 나누어 진행하는 것이 좋습니다. 하지만 매번 수동으로 /model 명령어를 입력해 바꾸는 것은 매우 번거롭습니다.

이를 해결해 주는 것이 opusplan 모드입니다. 이 기능을 사용하면 수동 조작 없이도
✅ Plan(계획 수립) ➔ 자동 Opus 사용
✅ Code(실제 코딩) ➔ 자동 Sonnet 사용

으로 완벽한 하이브리드 워크플로우가 자동으로 진행됩니다.