Claude Code - Core Features Guide

Claude Code는 Anthropic이 개발한 터미널 기반 AI 어시스트턴트다.

• GUI나 IDE 확장 프로그램에 집중하는 것과 달리, Claude Code는 개발자의 핵심 작업 공간인 터미널(CLI) 환경에 직접 통합
• 이 접근 방식 덕분에 단순한 코드 생성을 넘어, Git 명령어 실행, 파일 시스템 조작, Bash 스크립트 실행, 테스트 구동 등 개발 워크플로우 전반에 직접 개입 가능

Claude Code 컨텍스트 관리 기술

AI 성능의 핵심인 컨텍스트를 Claude Code는 다음과 같은 고유한 명령어로 관리한다.

기능/명령어	핵심 역할	상세 설명
/init	초기 컨텍스트 학습	프로젝트 첫 실행 시 전체 구조와 코드를 스캔하고 색인화(RAG 준비)
CLAUDE.MD	영구적 컨텍스트 저장	AI가 항상 기억해야 할 아키텍처, 기술 스택, 코딩 규칙을 정의 (전역/프로젝트별 설정 가능)
@ (참조)	명시적 컨텍스트 주입	AI의 컨텍스트 윈도우에 특정 파일이나 폴더를 직접 지정하여 집중시킴

Claude Code 대화 및 세션 관리

컨텍스트 윈도우의 한계를 관리하고 AI의 기억을 제어하는 기능이다.

명령어	핵심 기능	사용 목적
/clear	컨텍스트 윈도우 초기화	(단기 기억 삭제) 컨텍스트 용량 초과 방지, 비용 절감, 새 작업 시작 시 혼선 방지
# (기록)	영구 컨텍스트로 승격	(단기 기억 -> 영구 기억) 대화 중 얻은 유용한 규칙이나 정보를 CLAUDE.MD에 저장
/compact	컨텍스트 요약	이전 맥락을 압축하여 유지하면서 컨텍스트 윈도우 여유 공간 확보 (성능 저하 시 유용)
/resume	이전 대화 복원	/clear로 지워진 내용을 다시 불러와 대화를 이어감
/export	세션 내보내기	현재 대화 내용을 마크다운 파일 등으로 백업 및 문서화
/rewind	체크 포인트 복원	특정 시점으로 대화 상태 및 코드 상태를 되돌림

상호작용 및 워크플로우

효율적인 입력을 통해 개발 워크플로우를 자동화하는 기능이다.

명령어 큐 (순차적 작업)

• 여러 명령을 연속 입력(Shift + Enter)하면, 큐에 쌓아두고 순차적으로 처리
• (예: 1. analyze project (Enter) 2. refactor code (Enter))

워크플로우 연동

• Git 연동: commit my changes with a descriptive message -> AI가 git diff를 분석하여 커밋 메시지 생성 및 실행
• 테스트/디버깅: run and fix failed tests -> AI가 테스트 실패 로그를 분석하고 코드 수정을 시도

IDE 연동 (IntelliJ 기준)

IntelliJ 플러그인과 함께 사용할 때의 추가적인 활용법이다.

• Diff 뷰 활용
  • AI가 제안한 코드 변경 사항을 터미널 텍스트가 아닌 IDE의 시각적인 Diff 뷰로 검토 가능
  • AI의 제안을 직관적으로 검토하고 수락(Accept)하거나 거부(Reject) 가능
• 컨텍스트 공유
  • 플러그인을 통해 현재 IDE에서 열린 파일이나 선택된 코드 블록을 Claude Code 컨텍스트로 쉽게 공유

Claude Code 권한 모드 (Permission Mode)

AI 모델이 생성한 코드나 명령어를 실행할 때 권한을 어떻게 처리할지를 결정하는 권한 모드 를 제공한다. 세션 시작 시 CLI 플래그로 지정하거나, 세션 중 Shift+Tab으로 순환 전환할 수 있다.

모드	설명
default	도구 실행 시마다 사용자 승인을 요청하는 기본 모드
acceptEdits	파일 편집 권한을 세션 동안 자동 승인
plan	파일 분석만 가능, 수정·명령어 실행은 차단 (읽기 전용)
bypassPermissions	모든 권한 확인을 건너뜀 (격리된 환경에서만 권장)

Plan Mode

plan 모드는 실제 변경 없이 코드베이스를 분석하고 구현 계획을 수립하는 데 집중하는 모드다.

• 파일 읽기·분석만 허용, 쓰기·명령어 실행은 차단
• Claude가 변경 대상 파일, 수정 내용, 작업 순서를 계획서로 제시
• 사용자가 계획을 검토·승인한 뒤 다른 모드로 전환하여 실제 구현 진행

Plan Mode가 유용한 상황은 다음과 같다.

• 여러 파일에 걸친 대규모 변경 전 영향 범위 파악
• 되돌리기 어려운 구조적 변경 작업의 사전 검토
• 팀 환경에서 구현 방향에 대한 사전 합의가 필요한 경우

모드 설정 방법

# CLI 플래그로 세션 시작 시 지정
claude --permission-mode plan

# 세션 중 Shift+Tab으로 순환 전환
# default → acceptEdits → plan → ...

.claude/settings.json에서 기본값을 고정할 수도 있다.

{
  "permissions": {
    "defaultMode": "plan"
  }
}