# Claude CLI 완전 가이드 v3: Interactive 모드 기본 사용법 ## Interactive 모드란? Interactive 모드는 Claude CLI의 기본 실행 모드입니다. 터미널에서 Claude와 실시간으로 대화하며 개발 작업을 수행합니다. ```bash claude ``` --- ## 세션 관리 단축키 ### 기본 제어 | 단축키 | 기능 | |--------|------| | `Ctrl+C` | 현재 작업 취소 | | `Ctrl+D` | Claude Code 종료 | | `Ctrl+L` | 화면 클리어 (히스토리 유지) | | `Ctrl+R` | 명령어 히스토리 검색 | | `Ctrl+O` | Verbose 출력 토글 | ### 상태 관리 | 단축키 | 기능 | |--------|------| | `Esc` + `Esc` | 대화 되돌리기 (Rewind) - 변경사항과 대화 모두 복원 | | `Tab` | Extended Thinking 모드 토글 | | `Shift+Tab` 또는 `Alt+M` | Permission 모드 전환 (Auto/Plan/Ask) | --- ## 입력 방법 ### 한 줄 입력 프롬프트에 직접 입력: ``` > 이 함수를 리팩토링해줘 ``` ### 멀티라인 입력 여러 줄에 걸친 입력이 필요할 때: | 방법 | 설명 | |------|------| | `\` + `Enter` | 줄 연속 (백슬래시로 이어쓰기) | | `Option+Enter` | macOS에서 멀티라인 모드 | | `Shift+Enter` | 터미널 설정 후 사용 가능 | | `Ctrl+J` | 대체 멀티라인 바인딩 | **Shift+Enter 설정:** ``` /terminal-setup ``` iTerm2와 VS Code 터미널에 Shift+Enter 바인딩을 설치합니다. ### 특수 접두사 | 접두사 | 기능 | 예시 | |--------|------|------| | `/` | 슬래시 명령어 | `/help`, `/clear` | | `!` | Bash 명령 직접 실행 | `!npm test` | | `@` | 파일 경로 자동완성 | `@src/index.js` | | `#` | 메모리 기능 접근 | `#` (CLAUDE.md 표시) | --- ## 이미지 입력 Claude는 이미지를 직접 분석할 수 있습니다. ### 이미지 붙여넣기 | 플랫폼 | 단축키 | |--------|--------| | macOS/Linux | `Ctrl+V` | | Windows | `Alt+V` | ### 활용 예시 1. **UI 스크린샷 분석**: 디자인 구현 요청 2. **에러 스크린샷**: 오류 메시지 분석 3. **다이어그램**: 아키텍처 이해 및 구현 ``` > [이미지 붙여넣기 후] > 이 UI를 React 컴포넌트로 구현해줘 ``` --- ## Vim 모드 터미널에서 Vim 스타일 편집을 선호하는 사용자를 위한 모드입니다. ### 활성화 ``` /vim ``` 영구 활성화는 설정에서 가능합니다. ### 주요 Vim 키 바인딩 **이동:** | 키 | 동작 | |----|------| | `h` `j` `k` `l` | 좌/하/상/우 이동 | | `w` | 다음 단어 | | `b` | 이전 단어 | | `e` | 단어 끝 | | `0` | 줄 시작 | | `$` | 줄 끝 | **편집:** | 키 | 동작 | |----|------| | `i` | Insert 모드 진입 | | `a` | 커서 뒤에서 Insert | | `x` | 문자 삭제 | | `dd` | 줄 삭제 | | `cc` | 줄 변경 | | `cw` | 단어 변경 | | `u` | 실행 취소 | | `Esc` | Normal 모드로 복귀 | --- ## 백그라운드 명령 실행 오래 걸리는 명령을 백그라운드에서 실행할 수 있습니다. ### 백그라운드 실행 ``` !npm run build & ``` `&`를 붙여 백그라운드 실행 ### 백그라운드 작업 관리 ``` /bashes ``` 현재 실행 중인 백그라운드 작업 목록을 확인합니다. ### 활용 예시 ``` > !npm run dev & > 서버가 시작되는 동안 다른 파일을 수정해줘 ``` --- ## 파일 참조 ### @ 문법 `@`를 사용하여 파일을 직접 참조합니다: ``` > @src/components/Button.tsx 이 컴포넌트에 hover 효과를 추가해줘 ``` ### 여러 파일 참조 ``` > @src/api/user.js @src/models/user.js 이 두 파일의 타입을 맞춰줘 ``` ### 디렉토리 참조 ``` > @src/components/ 폴더의 모든 컴포넌트를 분석해줘 ``` --- ## Extended Thinking 모드 복잡한 문제에 대해 Claude가 더 깊이 생각하도록 합니다. ### 토글 방법 ``` Tab ``` 활성화되면 Claude가 더 긴 추론 과정을 거쳐 답변합니다. ### 적합한 상황 - 복잡한 아키텍처 설계 - 어려운 알고리즘 문제 - 대규모 리팩토링 계획 - 보안 취약점 분석 --- ## Permission 모드 전환 ### 전환 방법 ``` Shift+Tab 또는 Alt+M ``` ### 세 가지 모드 | 모드 | 동작 | 사용 시점 | |------|------|----------| | **Ask** | 매번 승인 요청 | 기본값, 안전한 작업 | | **Auto** | 자동 승인 | 신뢰할 수 있는 작업 | | **Plan** | 읽기 전용 | 코드 분석만 할 때 | 상태 표시줄에서 현재 모드를 확인할 수 있습니다. --- ## 세션 히스토리 ### 히스토리 검색 ``` Ctrl+R ``` 현재 디렉토리의 이전 명령어를 검색합니다. ### 세션 저장 ``` /export conversation.md ``` 현재 대화를 파일로 저장합니다. ### 이전 세션 재개 ``` /resume ``` 이전 세션 목록에서 선택하여 재개합니다. --- ## 대화 되돌리기 (Rewind) ### 사용 방법 ``` Esc + Esc ``` 또는 ``` /rewind ``` ### 동작 - 이전 대화 상태로 복원 - Claude가 수정한 파일도 원래대로 복원 - 실수로 잘못된 변경을 했을 때 유용 --- ## 컨텍스트 관리 ### 컨텍스트 시각화 ``` /context ``` 현재 세션에서 사용 중인 컨텍스트를 색상 그리드로 표시합니다. ### 대화 압축 ``` /compact ``` 긴 대화를 요약하여 토큰을 절약합니다. ``` /compact 최근 변경사항에 집중해줘 ``` 특정 내용에 집중하도록 지시할 수 있습니다. --- ## 유용한 팁 ### 1. 프로젝트 루트에서 시작 ```bash cd /your/project/root claude ``` Claude가 프로젝트 전체 구조를 이해할 수 있습니다. ### 2. 구체적으로 요청 ``` # 나쁜 예 > 코드 수정해줘 # 좋은 예 > @src/api/auth.js의 login 함수에서 토큰 만료 처리를 추가해줘 ``` ### 3. 단계적 접근 ``` > 먼저 현재 코드 구조를 분석해줘 > [분석 확인 후] > 이제 리팩토링 계획을 세워줘 > [계획 확인 후] > 계획대로 진행해줘 ``` ### 4. 변경 전 확인 Claude가 파일을 수정하기 전에 변경 내용을 미리 보여줍니다. 꼼꼼히 확인한 후 승인하세요. --- ## 다음 단계 v3에서는 Interactive 모드의 기본 사용법을 다뤘습니다. **다음 v4에서는**: - 40개 이상의 슬래시 명령어 완전 가이드 - 커스텀 슬래시 명령어 만들기 - MCP 슬래시 명령어 를 상세히 알아봅니다. --- ## 빠른 참조 카드 ``` 세션 제어 Ctrl+C 작업 취소 Ctrl+D 종료 Ctrl+L 화면 클리어 Esc+Esc 되돌리기 모드 전환 Tab Extended Thinking 토글 Shift+Tab Permission 모드 전환 입력 / 슬래시 명령어 ! Bash 실행 @ 파일 참조 # 메모리 접근 이미지 Ctrl+V 이미지 붙여넣기 (macOS/Linux) Alt+V 이미지 붙여넣기 (Windows) ``` --- *Claude CLI 완전 가이드 시리즈 v3/10*