Claude Code 입문 강의 요약 #3
Anthropic SkillJar의 Claude Code 강의를 듣고 정리한 내용입니다.
https://anthropic.skilljar.com/claude-code-in-action
ESC로 작업 제어하기
작업 중단하기
Write tests for the @src/lib/auth.ts file을 입력하면 Claude는 한 번에 많은 양의 테스트 코드를 작성합니다.
한 번에 하나의 테스트만 작성하게 하고 싶다면, 작업 진행 중에 ESC로 중단할 수 있습니다.
이후 Write tests for the createSession function처럼 범위를 좁혀서 다시 요청하면 됩니다.
ESC + Memory: 반복 에러 방지
작업 중 Claude가 파일 경로를 잘못 인식해서 매번 같은 에러가 반복되는 경우,
ESC로 작업을 중단한 뒤 #(memory mode)으로 CLAUDE.md에 올바른 경로나 에러 대응 방법을 정의할 수 있습니다.
이후 continue를 입력하면 수정된 지시사항을 반영해서 작업을 이어갑니다.
💡 일시적인 수정이 아니라, 같은 에러가 다시 발생하지 않도록 CLAUDE.md에 영구적으로 기록하는 것이 핵심입니다.
ESC + ESC: 대화 Rewind(되돌리기)
왜 필요한가?
예를 들어 createSession 함수의 테스트를 작성하는 과정에서 에러가 발생해 디버깅 대화가 길어진 상황을 가정합니다.
디버깅이 완료된 후, 이번엔 getSession 함수의 테스트를 작성하려고 합니다.
그런데 createSession 디버깅 과정의 대화는 getSession 테스트와 아무 관련이 없습니다.
불필요한 컨텍스트가 남아 있으면 Claude가 새 작업을 수행할 때 방해가 될 수 있습니다.
이때 ESC + ESC로 특정 시점의 대화로 되돌아갈 수 있습니다.
사용 방법:
whats in the @src/lib/auth.ts file?을 입력하면 Claude는 아래와 같은 함수 목록을 포함한 결과를 반환합니다.
Functions
createSession(userId: string, email: string)
- Creates a JWT token with 7-day expiration
- Sets an HTTP-only cookie with security flags
- Cookie is secure in production, lax sameSite policy
getSession(): Promise<SessionPayload | null>
- Reads the auth token from cookies
- Verifies and decodes the JWT
- Returns session payload or null if invalid/missingcreateSession 함수 테스트를 요청하면 에러가 발생하고,
Claude가 자동으로 디버깅을 진행합니다.
디버깅 과정은 다음과 같이 진행됩니다.
- 의존성 설치 후
createSession테스트 실행 server-only모듈 오류 발생 → 테스트 환경에서 모킹하도록 파일 수정- 테스트 재실행 및 성공
디버깅이 완료된 후 getSession 테스트로 넘어가려면, 앞서 쌓인 디버깅 대화를 제거해야 합니다.
ESC + ESC를 누르면 되돌아갈 시점을 선택할 수 있습니다.
시점을 선택하면 이전 입력값이 입력창에 자동으로 채워지며,
해당 텍스트를 수정해서 새 요청을 보내면 됩니다.
Context 관리 명령어
대화가 길어지면 컨텍스트 윈도우가 가득 차서 Claude의 응답 품질이 저하될 수 있습니다.
이때 아래 두 명령어로 컨텍스트를 정리할 수 있습니다.
| 명령어 | 동작 | 사용 상황 |
|---|---|---|
/compact | 중요 정보는 유지하면서 전체 대화를 요약 | 관련 작업을 계속 이어갈 때 |
/clear | 대화 기록을 완전히 삭제 | 전혀 다른 작업을 시작할 때 |
/compact
Claude가 학습한 중요 정보(프로젝트 구조, 발견한 버그 등)를 유지하면서
전체 대화 기록을 요약해 컨텍스트 윈도우를 절약합니다.
아래와 같은 상황에서 유용합니다.
- Claude가 프로젝트에 대한 중요한 정보를 파악한 상태일 때
- 관련된 작업을 계속 이어서 진행하고 싶을 때
- 대화가 길어졌지만 중요한 컨텍스트가 포함되어 있을 때
/clear
대화 기록을 완전히 삭제하고 처음부터 시작합니다.
아래와 같은 상황에서 유용합니다.
- 완전히 다른 작업을 시작할 때
- 이전 대화의 맥락이 새 작업에 방해가 될 때
- 깨끗한 상태에서 시작하고 싶을 때
