기본 워크플로우 - Databricks 가이드

한 줄 요약

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/ 경로에 사용자 프로필·피드백·프로젝트 사실을 자동 저장하는 자동 메모리 시스템이 활성화됩니다. 사용자가 “이거 기억해줘”라고 말하면 거기에 영구 저장됩니다.

효과적인 프롬프트 작성

나쁜 예 (너무 짧음)

> bug 고쳐줘

좋은 예 (목표 + 상황 + 제약)

> 사용자 로그인이 5분 후 강제 만료되는 버그가 있어.
  관련 코드는 src/auth/session.ts에 있을 거 같고,
  토큰 만료가 아니라 세션 갱신 로직 문제로 의심돼.
  쿠키 만료 시간이 5분으로 하드코딩된 곳이 있는지 찾아보고,
  찾으면 환경 변수로 바꿔줘 (기본값 1시간).

더 좋은 예 (검증 단계 명시)

> 위 작업 후, src/auth/__tests__/session.test.ts에 테스트 추가하고
  npm run test로 통과 확인해줘. 테스트 미통과면 끝났다고 하지 말 것.

멀티 파일 / 대규모 변경 흐름

복잡한 작업은 계획 → 실행 → 검증 → 커밋 4단계로 분리합니다:

1단계: 계획 모드로 진입

> /plan
> 사용자 인증 시스템에 OAuth2 추가하고 싶어. 현재 구조 분석하고 단계별 계획 줘.

Claude가 코드베이스를 탐색한 뒤 계획을 제시. 실행은 차단됩니다.

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와의 연계 활용을 다룹니다.

​한 줄 요약

​핵심 모드 — 무엇을 할 때 어떤 모드?

​자주 쓰는 슬래시 커맨드

​/init — 새 프로젝트에 CLAUDE.md 생성

​/clear — 대화 컨텍스트 초기화

​/compact — 대화 압축

​/help — 사용 가능한 명령 목록

​/model — 모델 전환

​/cost — 누적 사용량 확인

​/review — PR 또는 변경사항 리뷰

​/permissions — 권한 화이트리스트 인터랙티브 편집

​메모리 시스템 — 세션을 넘어 기억

​1. 단기 메모리 — 현재 대화

​2. 프로젝트 컨텍스트 — CLAUDE.md

​3. 사용자 글로벌 컨텍스트 — ~/.claude/CLAUDE.md

​4. 자동 메모리 (선택)

​효과적인 프롬프트 작성

​나쁜 예 (너무 짧음)

​좋은 예 (목표 + 상황 + 제약)

​더 좋은 예 (검증 단계 명시)

​멀티 파일 / 대규모 변경 흐름

​1단계: 계획 모드로 진입

​2단계: 계획 검토 후 승인

​3단계: 실행

​4단계: 검증

​Git 통합 패턴

​커밋 메시지 자동 생성

​PR 생성

​커밋 전 검증 후크

​흔한 실수와 피하는 법

​단축키 치트 시트

​다음 단계