Claude Code 치트 시트 — 제가 매일 실제로 사용하는 명령어 15가지 - Insights

※ 본 기사의 일본어 번역에는 다소 부자연스러운 부분이 있을 수 있습니다. AI 언어 지원을 활용하여 작성되었습니다.

서론
1. 세 가지 모드 — 먼저 올바르게 선택하기
1. 자주 사용하는 슬래시 명령어 7가지
1. 컨텍스트 관리 — 가장 중요한 스킬
1. CLAUDE.md — AI와의 계약서
1. 보안 — AI에게 비밀 정보를 읽히지 않게 하기
1. 권한 — 신뢰에는 레벨이 있다
1. 매일 사용하는 세 가지 조합
1. 작은 요령 — 하지만 시간을 절약할 수 있다
1. 모델 선택 — 항상 최강의 모델을 사용하지 않기
1. One-shot 모드로 자동화하기
요약
마지막으로

이 글은 Claude Code를 사용하기 시작한 분, 또는 사용하고 있지만 '더 효율적으로 사용하고 싶다'고 생각하는 개발자를 대상으로 합니다.

필자 소개: 저는 현재 일본 시장을 목표로 하는 시스템 개발을 담당하는 TOMOSIA VIETNAM에서 엔지니어로 일하고 있습니다. Claude Code를 매일 사용하면서 정말 필요한 명령어들만 모은 '나만의 치트 시트'를 만들었습니다.

이 글의 목적:

Claude Code의 명령어를 모두 외울 필요가 없다는 것을 전달하는 것 - 실제 업무에서 사용하는 15개의 명령어로 좁혀서 소개하는 것 - 왜 그 명령어를 사용해야 하는지, 언제 사용해야 하는지를 설명하는 것입니다.

예상 독자:

Claude Code를 막 시작한 분
명령어가 너무 많아 혼란스러운 분
매일 업무에서 Claude Code를 효율적으로 사용하고 싶은 분

개요: Claude Code에는 수십 개의 명령어와 단축키가 있습니다. 하지만 실제로 사용해 보면 정말 필요한 것은 약 15개뿐이라는 것을 깨달았습니다. 이 글은 저의 치트 시트입니다. 모든 것을 나열하기보다는 매일 사용하는 것과 그 이유를 소개합니다.

Claude Code에는 세 가지 실행 방법이 있습니다. 초보자들이 흔히 하는 가장 큰 실수는 잘못된 모드를 선택하는 것입니다.

모드	명령어	언제 사용하나요?
REPL(대화)	`claude`	여러 단계의 디버깅, 코드베이스 탐색, 학습 시
One-shot	`claude -p "..."`	간단한 질문, 자동화, CI/CD 작업 시
Pipe	`cat file	claude -p "..."`

# 여러 단계의 디버깅 → REPL
claude
# 간단한 질문 → one-shot
...

저의 교훈: 한 줄짜리 질문에 REPL을 사용하지 마세요. 여러 파일 수정에 One-shot을 사용하지 마세요.

수많은 / 명령어 중에서 제가 자주 사용하는 것은 다음 7가지뿐입니다.

명령어	효과	언제 사용하나요?
`/init`	프로젝트용 `CLAUDE.md`를 생성합니다.	새로운 프로젝트에서 처음 작업할 때
`/cost`	사용 토큰과 비용을 표시합니다.	20~30분마다
`/compact`	대화 기록을 압축합니다.	컨텍스트가 50~70%일 때
`/clear`	모든 컨텍스트를 삭제합니다.	관련 없는 작업으로 전환할 때
`/context`	컨텍스트 창의 사용량을 표시합니다.	AI가 '잊었다'고 느낄 때
`/model`	세션 중에 모델을 변경합니다.	더 강력한 모델, 또는 저렴한 모델이 필요할 때
`/resume`	이전 세션으로 돌아갑니다.	도중에 하던 작업을 계속할 때

이것은 가장 흔한 오해입니다:

/compact
→ 기록을 압축하여 현재 작업의 컨텍스트를 유지합니다.
/clear
→ 모든 것을 삭제하고 처음부터 다시 시작합니다.

저의 규칙:

작업 도중 →
/compact
다른 프로젝트로 전환할 때 →
/clear

⚠️
작업 중에 AI가 이해했던 작업의 문맥이 모두 사라집니다. /clear를 사용하지 마세요.

이 글에서 단 하나만 배운다면, 컨텍스트 관리를 배우세요.

Claude Code의 컨텍스트 창에는 한계가 있습니다. 가득 차면 답변의 질이 확연히 떨어집니다. AI가 이전에 나눴던 이야기를 '잊기' 시작합니다.

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

레벨	품질	행동
0〜50%	좋음	작업을 계속 진행합니다
50〜70%	보통	`/compact` 준비
70〜85%	떨어지기 시작함	즉시 `/compact`를 실행합니다
85〜95%	나쁨	`compact` 또는 `clear`가 필요합니다
95% 이상	신뢰할 수 없음	`/clear`로 초기화하고 처음부터 다시 시작합니다

# 20〜30분마다 한 번 확인
/cost
# 컨텍스트가 50〜70%라면
...

왜 /cost가 중요한가요? 토큰과 비용(돈) 둘 다 알 수 있기 때문입니다. 예전에 세션을 너무 오래 열어둔 나머지, 자신도 모르게 평소의 3배에 달하는 비용이 발생한 적이 있습니다.

CLAUDE.md는 프로젝트에서 가장 중요한 파일입니다. Claude에게 "이 프로젝트가 무엇인지, 규칙은 무엇인지, 무엇을 하면 안 되는지"를 알려줍니다.

# Project: [프로젝트명]
## 1. Project Overview
Tech stack: Node.js 20, Express, PostgreSQL, Redis
...

크기	토큰	품질
300〜500단어	약400〜650	너무 짧음 — 엣지 케이스가 빠짐
500〜800단어	약650〜1000	대부분의 프로젝트에 최적
800〜1200단어	약1000〜1500	충분함 — 대형 프로젝트용
1200단어 이상	1500 이상	너무 김 — 효과 감소

⚠️

프로젝트 메모리에 사용할 토큰은 실제 작업에 CLAUDE.md는 1000단어 이하로 유지해 주세요. 사용 불가능한 토큰입니다.

위치	범위	우선순위
`~/.claude/CLAUDE.md`	글로벌 (모든 프로젝트)	최저
`./CLAUDE.md`	프로젝트 루트	메인 — 이것을 사용합니다
`./src/CLAUDE.md`	디렉토리 단위	최고 (루트 덮어쓰기)

이것은 많은 사람이 놓치는 가장 중요한 부분입니다.

# .gitignore — 절대 커밋하지 않음
.env
.env.local
...

# .env.example — git에 커밋하고 Claude가 읽을 수 있음
DATABASE_URL=postgresql://username:password@localhost:5432/dbname
API_KEY=your_api_key_here
...

🔴

Claude에게 절대로 더미 값의 .env 파일을 직접 읽게 하지 마세요. .env.example을 사용하세요. 비밀 정보가 유출되면 즉시 로테이션(rotation) 해주세요.

Claude Code에는 권한 시스템이 있습니다. 저는 다음과 같이 분류했습니다.

명령어 종류	행동
`ls` , `pwd` , `cat` , `grep` , `find`	✅ 자유 허용 (읽기 전용)
`git status` , `git log` , `git diff`	✅ 허용 (git 읽기 전용)
`git commit -m "..."`	⚠️ 메시지 검토 후 승인
`npm install <package>`	⚠️ 패키지 이름 먼저 확인
`src/` 내 파일 쓰기	⚠️ 경로와 내용 확인
`rm` , `git push --force`	❌ 의도가 없는 한 항상 거부
---	---
`curl` , `wget`	❌ 항상 거부 — 데이터 유출 위험
`~/.ssh/` , `~/.aws/` 조작	❌ 항상 거부 — 기밀 디렉토리

# 읽기 및 일부 git 명령어만 허용
claude --allowedTools "Read" "Bash(git *)"

조합 (Combo)	워크플로우 (Workflow)	언제 사용?
`/cost` → `/compact`	확인(체크) → 압축	정기 유지보수 (30분마다)
`/clear` → `/init`	초기화(리셋) → 설정	새로운 프로젝트 시작 시
`/compact` → 작업 → `/cost`	압축 → 계속 진행 → 확인	긴 작업 세션

cd my-project
claude # 세션 시작
/init # CLAUDE.md 생성
...

# 20~30분마다:
/cost # 컨텍스트를 확인
# 컨텍스트가 50~70%일 때:
...

방법 (Method)	기능
`\` + Enter	줄 바꿈 (여러 줄 입력 시)
`Shift+Enter`	줄 바꿈 (`/terminal-setup` 실행 후)
`! npm test`	Bash 모드 — AI 개입 없이 쉘 명령어 실행
`@src/utils/auth.js`	파일 참조, `Tab` 키로 자동 완성
`Ctrl+V`	클립보드에서 이미지 붙여넣기

단축키 (Shortcut)	효과
`Escape`	현재 턴 중단 — 세션과 컨텍스트는 유지됨
`Escape` × 2	Rewind — 메시지 선택 메뉴에서 undo 실행
`Ctrl+C` × 2	세션 종료
`Shift+Tab`	권한 모드 전환 (Normal → Auto-Accept → Plan)

💡

AI가 잘못된 방향으로 진행되면, Escape는 제가 가장 자주 사용하는 단축키입니다. Escape로 멈춥니다 — 컨텍스트는 손실되지 않습니다. Ctrl+C로 재시작하지 마세요.

| 모델 (Model) | 비용 (Cost) | 용도 (Use Case) |
|---|---|
Haiku | $ | 포맷팅, 오타 수정, 간단한 질문 |
Sonnet | $$ | 대부분의 작업 기본값 — 기능 구현, 디버깅, 리뷰 |
Opus | $$$ | 아키텍처 설계, 복잡한 디버깅, 보안, 새로운 문제 해결 |

저의 원칙:

기본값 → Sonnet - 간단한 수정 → Haiku - 아키텍처, 깊은 추론이 필요할 때 → Opus

세션 중에는 /model, CLI에서는 claude --model sonnet로 변경할 수 있습니다.

자주 사용되지는 않지만, CI/CD에서 매우 강력한 부분입니다.

# 자동화용 JSON 출력
claude -p --output-format json "list all TODO comments in src/"
# agentic 턴 수 제한 (무한 루프 방지)
...

왜 --max-budget-usd가 중요한가? AI가 루프를 실행하여 비용이 통제 불능 상태가 되는 것을 막아주기 때문입니다.

Claude Code에는 많은 명령어가 있습니다. 하지만 모두 외울 필요는 없습니다.

제가 매일 사용하는 15가지 명령어:

그룹	명령어
모드 (Mode)	`claude` , `claude -p` , `cat file
슬래시 (Slash)	`/init` , `/cost` , `/compact` , `/clear` , `/context` , `/model` , `/resume`
입력 (Input)	`\` + Enter, `!` (bash 모드), `@` (파일 참조)
키보드 (Keyboard)	`Escape` , `Escape` × 2, `Shift+Tab`
CLI 플래그 (Flag)	`--model` , `--max-budget-usd` , `--allowedTools`

가장 중요한 세 가지:

컨텍스트 관리—/cost와 /compact를 자주 사용하기 -
좋은 습관— 1000단어 이하, 6개 섹션의 CLAUDE.md 작성 -
비밀 정보 보호— AI에게 .env 파일을 절대 읽히지 않게 하기

처음 시작했다면, 먼저 위 세 가지에 집중하세요. 다른 명령어들은 자연스럽게 익숙해질 것입니다.

여기까지 읽어주셔서 대단히 감사합니다.

혹시 "시스템 개발을 의뢰하고 싶다", "기술적인 상담이 필요하다", "AI를 활용한 문제 해결 아이디어가 있다" 등의 고민이 있으시다면, 저희 TOMOSIA VIETNAM에 문의해 주십시오.

💻 소프트웨어 수주 개발 (Web/앱/시스템) - 🤖 AI 솔루션 (챗봇, 이미지 처리, LLM 응용) - 📱 모바일 앱 개발 (iOS / Android) - 🔌 Fintech / IoT 개발 - 🔧 브릿지 SE(BrSE) 지원 (일본어 커뮤니케이션 원활화)
ISO/IEC 27001 (정보 보안) 인증 취득 완료 – 안심하고 맡기실 수 있습니다 -
일본어 대응 팀 – 일본의 문화 및 비즈니스 관습을 이해한 멤버가 직접 대응합니다 -
"Win-Win, Happy Together" 문화 – 장기적인 파트너십을 소중히 여깁니다

🔗 공식 웹사이트: tomosia.com

우선 부담 없이 한마디 연락 주십시오. 저희와 함께 "베트남의 지혜"로 세계에 도전해 보시지 않겠습니까?

Claude Code 치트 시트 — 제가 매일 실제로 사용하는 명령어 15가지

요약

핵심 포인트

이 글의 목적:

댓글

이 글의 목적: