Documentation Index
Fetch the complete documentation index at: https://docs.sifi.life/llms.txt
Use this file to discover all available pages before exploring further.
한 줄 요약
Claude Code의 일상 사용은 세 가지 모드와 핵심 슬래시 커맨드 한 줌만 알면 90% 커버됩니다.
핵심 모드 — 무엇을 할 때 어떤 모드?
| 모드 | 진입 방법 | 언제 쓰나 |
|---|
| 기본 (Interactive) | claude | 질문·답변, 가벼운 수정. 매 도구 호출마다 권한 확인 |
| Plan 모드 | Shift+Tab으로 사이클 또는 > /plan | 큰 작업을 시작하기 전에 계획만 세우고 실행은 차단 |
| Auto 모드 | Shift+Tab으로 사이클 | 명백히 안전한 작업을 자율적으로 연속 실행 |
| Bypass 모드 | --dangerously-skip-permissions | 모든 권한 확인 우회. 격리된 컨테이너에서만 권장 |
추천 패턴: 큰 변경은 /plan으로 계획 → 검토 → 승인 → 실행. 자잘한 작업은 기본 모드.
자주 쓰는 슬래시 커맨드
/init — 새 프로젝트에 CLAUDE.md 생성
프로젝트를 처음 열었을 때 한 번만 실행합니다.
/clear — 대화 컨텍스트 초기화
긴 대화로 컨텍스트가 무거워졌을 때, 또는 완전히 다른 작업으로 전환할 때.
/compact — 대화 압축
컨텍스트는 유지하되 토큰 사용량을 줄이고 싶을 때. /clear보다 부드러운 옵션.
/help — 사용 가능한 명령 목록
/model — 모델 전환
claude-opus-4-7 — 가장 강력, 복잡한 추론·아키텍처 설계claude-sonnet-4-6 — 일반 작업 기본값, 균형claude-haiku-4-5 — 빠른 응답, 단순 작업
/cost — 누적 사용량 확인
세션 동안 토큰 사용량과 비용을 표시.
/review — PR 또는 변경사항 리뷰
/permissions — 권한 화이트리스트 인터랙티브 편집
메모리 시스템 — 세션을 넘어 기억
Claude Code는 세 가지 레벨의 메모리를 가집니다:
1. 단기 메모리 — 현재 대화
하나의 claude 세션 안에서만 유지. /clear하거나 종료하면 사라짐.
2. 프로젝트 컨텍스트 — CLAUDE.md
<project>/CLAUDE.md에 둔 모든 내용은 모든 세션 시작 시 자동 로드.
3. 사용자 글로벌 컨텍스트 — ~/.claude/CLAUDE.md
모든 프로젝트에서 자동 로드.
4. 자동 메모리 (선택)
일부 환경에서는 ~/.claude/projects/<프로젝트>/memory/ 경로에 사용자 프로필·피드백·프로젝트 사실을 자동 저장하는 자동 메모리 시스템이 활성화됩니다. 사용자가 “이거 기억해줘”라고 말하면 거기에 영구 저장됩니다.
효과적인 프롬프트 작성
나쁜 예 (너무 짧음)
좋은 예 (목표 + 상황 + 제약)
> 사용자 로그인이 5분 후 강제 만료되는 버그가 있어.
관련 코드는 src/auth/session.ts에 있을 거 같고,
토큰 만료가 아니라 세션 갱신 로직 문제로 의심돼.
쿠키 만료 시간이 5분으로 하드코딩된 곳이 있는지 찾아보고,
찾으면 환경 변수로 바꿔줘 (기본값 1시간).
더 좋은 예 (검증 단계 명시)
> 위 작업 후, src/auth/__tests__/session.test.ts에 테스트 추가하고
npm run test로 통과 확인해줘. 테스트 미통과면 끝났다고 하지 말 것.
멀티 파일 / 대규모 변경 흐름
복잡한 작업은 계획 → 실행 → 검증 → 커밋 4단계로 분리합니다:
1단계: 계획 모드로 진입
> /plan
> 사용자 인증 시스템에 OAuth2 추가하고 싶어. 현재 구조 분석하고 단계별 계획 줘.
2단계: 계획 검토 후 승인
계획이 적절하면 Esc로 빠져나와 자동/기본 모드에서 실행을 지시.
3단계: 실행
> 위 계획대로 진행해줘. 각 단계 끝날 때마다 짧게 요약하고,
테스트 추가는 마지막이 아니라 단계마다 같이 해줘.
4단계: 검증
> 변경 후 npm run test와 npm run lint 둘 다 통과하는지 확인하고,
실패하면 원인을 알려줘 (자동 수정 시도하지 말고).
Git 통합 패턴
커밋 메시지 자동 생성
> 지금까지의 변경사항을 staged 후 conventional commit 형식으로 커밋해줘
PR 생성
> 현재 브랜치를 origin에 push하고 gh pr create로 PR 만들어줘.
PR 본문에 변경 요약, 테스트 plan, 스크린샷 위치(있다면)를 포함.
커밋 전 검증 후크
.claude/settings.json에 PreCommit 훅을 등록하면, Claude가 커밋 명령을 실행하기 전에 자동으로 lint/test가 돌아갑니다 (자동화와 후크 참조).
흔한 실수와 피하는 법
| 실수 | 결과 | 피하는 법 |
|---|
| 짧은 프롬프트(“이거 고쳐줘”) | 엉뚱한 곳 수정 | 목표·파일·검증 기준 명시 |
| 검증 없이 “완료” 선언 | 동작 안 하는 코드 머지 | ”테스트까지 통과 후 완료”를 프롬프트에 포함 |
| 큰 작업을 한 번에 요청 | 컨텍스트 폭주, 부분 실패 | /plan으로 분할 후 단계 실행 |
| 시크릿 파일 노출 | API 키 학습 데이터에 포함 | .claudeignore에 .env 등 추가 |
| 모든 권한 자동 승인 | 잘못된 명령이 실수로 실행 | 위험 명령은 화이트리스트에서 제외 |
단축키 치트 시트
| 키 | 기능 |
|---|
Shift+Tab | 모드 사이클 (기본 ↔ Plan ↔ Auto) |
Esc | 현재 작업 취소 / 모드 빠져나오기 |
Ctrl+C (두 번) | Claude Code 종료 |
Ctrl+L | 화면 클리어 (대화는 유지) |
↑ / ↓ | 이전 프롬프트 탐색 |
! 시작 | Bash 명령 직접 실행 (!ls, !git status) |
@ | 파일 자동완성 (@src/main.ts) |
다음 단계
다음 페이지에서 Databricks와의 연계 활용을 다룹니다.