Claude Code 치트시트 — 터미널 기반 AI 코딩의 핵심 명령어 총정리

Claude Code, 제대로 쓰고 계신가요?

Anthropic의 Claude Code는 터미널에서 직접 동작하는 AI 코딩 에이전트입니다. VS Code나 Cursor 같은 GUI 기반 도구와 달리, 셸 환경에서 자연어로 지시하면 파일을 읽고, 수정하고, 명령을 실행하고, git 작업까지 처리해줍니다. 강력한 도구이지만 터미널 기반이다 보니 어떤 명령과 기능이 있는지 한눈에 파악하기 어렵다는 피드백도 있었습니다. 최근 공유된 Claude Code 치트시트는 이런 부분을 깔끔하게 정리한 레퍼런스입니다.

핵심 기능과 명령어 구조

Claude Code의 기본 사용법은 터미널에서 claude 명령으로 대화형 세션을 시작하거나, claude -p "질문" 형태로 원샷 질문을 던지는 것입니다. 하지만 그 안에는 생각보다 풍부한 기능이 숨어 있습니다.

슬래시 명령어가 핵심입니다. /init은 프로젝트를 분석하고 CLAUDE.md 파일을 자동 생성해줍니다. 이 파일은 프로젝트의 컨텍스트를 Claude에게 전달하는 역할을 하는데, 프로젝트 구조, 빌드 방법, 코딩 컨벤션 등을 담을 수 있습니다. /compact는 현재 대화의 컨텍스트를 압축해서 토큰을 절약합니다. 긴 작업을 하다 보면 컨텍스트 윈도우가 차는데, 이때 중간중간 /compact를 사용하면 핵심 정보는 유지하면서 대화를 이어갈 수 있습니다.

파이프라인 통합도 주목할 부분입니다. cat file.py | claude -p "이 코드 리뷰해줘"처럼 유닉스 파이프와 결합하면, 기존 셸 워크플로에 AI를 자연스럽게 끼워넣을 수 있습니다. git diff | claude -p "커밋 메시지 작성해줘"같은 패턴도 실무에서 바로 활용 가능합니다.

권한 모드와 보안

Claude Code의 독특한 설계 중 하나는 권한 모드 시스템입니다. 기본적으로 파일 읽기는 자유롭게 허용하지만, 파일 수정이나 셸 명령 실행은 사용자 승인을 요청합니다. --dangerously-skip-permissions 플래그를 사용하면 이 제한을 해제할 수 있지만, 이름에서 알 수 있듯이 권장되지는 않습니다. CI/CD 환경에서 자동화할 때만 제한적으로 사용하는 것이 좋습니다.

--allowedTools 옵션으로 특정 도구만 선택적으로 허용할 수도 있습니다. 예를 들어 읽기와 검색만 허용하고 쓰기는 차단하는 "읽기 전용 모드"를 구성할 수 있어서, 코드 분석이나 리뷰 용도로 안전하게 사용할 수 있습니다.

CLAUDE.md의 전략적 활용

치트시트에서 특히 유용한 부분은 CLAUDE.md 파일의 활용 전략입니다. 이 파일은 단순한 프로젝트 설명을 넘어, AI 에이전트의 행동을 세밀하게 제어하는 도구로 사용할 수 있습니다.

프로젝트 루트에 놓는 것이 기본이지만, 하위 디렉토리에도 배치할 수 있습니다. 예를 들어 frontend/CLAUDE.md에는 React 컴포넌트 작성 규칙을, backend/CLAUDE.md에는 API 설계 원칙을 넣는 식입니다. Claude Code는 현재 작업 디렉토리를 기준으로 가장 가까운 CLAUDE.md를 우선 참조합니다.

효과적인 CLAUDE.md에 포함하면 좋은 내용은: 빌드 및 테스트 명령어, 코딩 스타일 가이드, 프로젝트의 주요 아키텍처 결정 사항, 자주 실수하는 부분에 대한 주의사항 등입니다. 잘 작성된 CLAUDE.md는 새 팀원의 온보딩 문서로도 활용할 수 있어서 일석이조입니다.

실전 활용 팁

치트시트에서 다루는 실전 패턴 중 몇 가지를 소개하면:

멀티파일 수정: "이 함수의 이름을 변경하고 모든 호출부도 함께 수정해줘"처럼 리팩토링을 자연어로 지시할 수 있습니다. Claude Code가 프로젝트 전체를 탐색해서 관련 파일을 찾아 수정합니다.
테스트 주도 개발: "이 함수에 대한 테스트를 먼저 작성하고, 테스트가 통과하도록 구현해줘"라고 하면 TDD 사이클을 에이전트가 직접 수행합니다.
Git 통합: 커밋, 브랜치 생성, PR 작성까지 자연어로 처리할 수 있습니다.

업계 맥락: 터미널 기반 AI 도구의 부상

GUI 기반의 Cursor나 Windsurf가 주류인 가운데, 터미널 기반 도구도 점점 영역을 넓히고 있습니다. Aider, Codex CLI 등이 비슷한 접근을 취하고 있으며, 이들의 공통점은 기존 개발자 워크플로(셸, 에디터, git)를 바꾸지 않고 AI를 끼워넣는다는 철학입니다. vim이나 neovim 사용자, 혹은 SSH 원격 개발 환경에서는 터미널 기반 도구가 오히려 더 자연스러울 수 있습니다.

한국 개발자에게 주는 시사점

Claude Code를 이미 쓰고 있다면 이 치트시트를 북마크해두고, CLAUDE.md 설정부터 최적화해보시길 권합니다. 아직 사용하지 않는다면, 터미널 중심 워크플로를 선호하는 분들께 한번 시도해볼 가치가 있습니다. 특히 서버 개발자나 DevOps 엔지니어처럼 터미널에서 많은 시간을 보내는 분들에게 적합합니다.