Claude Code Core Features and Usage 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가 테스트 실패 로그를 분석하고 코드 수정을 시도

고급 워크플로우: 자동화

커스텀 명령어 (Custom Command)

반복적인 프롬프트(예: 코드 리뷰, Git 커밋)를 나만의 명령어로 저장하여 자동화하는 기능이다.

• 생성: .claude/commands (프로젝트별) 또는 ~/.claude/commands (전역) 폴더에 .md 파일로 프롬프트 작성

• 파일 내용:

  • 순수 텍스트 프롬프트 작성

  • $ARGUMENTS 변수 사용 가능 (명령어 인자 전달용)

• 사용법: 터미널에서 /명령어이름 [인자] 형태로 호출

# 코드 리뷰어 역할을 하는 커스텀 명령어 예시

Review the code in the file `$ARGUMENTS`.
Please check for readability and potential null pointer exceptions (NPEs).

# 터미널에 명령어와 '인자(파일명)'를 함께 입력
/review src/main/java/UserService.java

IDE 연동 (IntelliJ 기준)

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

• Diff 뷰 활용

  • AI가 제안한 코드 변경 사항을 터미널 텍스트가 아닌 IDE의 시각적인 Diff 뷰로 검토 가능

  • AI의 제안을 직관적으로 검토하고 수락(Accept)하거나 거부(Reject) 가능

• 컨텍스트 공유

  • 플러그인을 통해 현재 IDE에서 열린 파일이나 선택된 코드 블록을 Claude Code 컨텍스트로 쉽게 공유

Claude Code 실행 권한

AI 모델(서버)이 생성한 코드나 명령어를 사용자 PC(클라이언트)에서 실행할 때의 제어 방식이다.

설정 / 옵션	설명	위험도
권한 요청 (Yes/No) (기본값)	AI가 생성한 파일 변경/Bash 명령어를 사용자가 검토하고 승인하는 안전장치	낮음
--dangerously-skip-permissions	모든 권한 요청을 건너뛰고 AI의 제안을 즉시 실행	높음