터미널 속 또 다른 팀원, Claude Code CLI 완전 정복 가이드
AI는 더 이상 선택이 아닌 필수가 된 시대입니다. 이제 개발자들도 더 이상 혼자서 코드와 싸울 필요가 없습니다. 특히 터미널 중심으로 일하는 개발자라면 Claude Code CLI는 꼭 한 번 경험해볼 만한 도구입니다. 단순한 채팅봇이 아닌, 프로젝트 구조를 이해하고 테스트 코드를 짜며, 코드 리뷰까지 수행하는 AI 개발 동료이자 생산성 강화 도구입니다.
이 블로그에서는 Claude Code CLI의 설치부터 기본 명령어, 고급 기능, 실제 개발 워크플로우 통합까지, 모든 것을 차근차근 살펴보며 어떻게 이 도구를 실무에 활용할 수 있는지 알려드립니다. 단순한 명령어 나열이 아닌, 어떤 상황에서 어떤 기능이 유용한지를 중심으로 설명하므로 실제 적용이 한결 쉬워질 것입니다.
1. 시작하기 – Claude Code CLI 설치와 기본 설정
Claude Code CLI는 Node.js 기반으로 작동합니다. 설치는 매우 간단합니다.
npm install -g @anthropic-ai/claude-code
설치가 완료되면 전역에서 claude 명령어로 접근할 수 있습니다.
세션 관리 명령어
- claude
새로운 세션을 시작합니다. 이전 대화 내용은 포함되지 않으며, 새로운 작업을 시작할 때 유용합니다. - claude --continue 또는 claude -c
마지막 세션을 이어서 계속합니다. 이전 맥락이 그대로 유지되므로 설명을 반복할 필요가 없습니다. - claude --resume 또는 claude -r
과거의 모든 세션 목록을 보여주고 선택하여 복귀할 수 있습니다. 프로젝트별로 나뉜 맥락을 손쉽게 불러올 수 있습니다.
환경 설정 팁
claude config set --global preferredNotifChannel terminal_bell
이 설정을 하면 Claude가 긴 작업을 완료했을 때 터미널 알림음을 울려줍니다. 다른 작업을 하며 기다릴 때 유용합니다.
2. 개발 루틴 최적화 – Slash 명령어의 실전 활용
Claude Code CLI의 핵심은 다양한 Slash 명령어에 있습니다. 대부분의 개발 루틴을 자동화하고 단순화할 수 있습니다.
/init
프로젝트 루트에 CLAUDE.md 파일을 생성합니다. 이 파일에 프로젝트 구조, 의존성, 개발 규칙 등을 적어두면 Claude가 이 정보를 바탕으로 질문에 더 정확하게 답합니다. 처음 설정할 때 Claude에게 도움을 요청해도 좋습니다.
/clear
현재 세션의 컨텍스트를 초기화합니다. 프로젝트는 유지되며, Claude에게 이전 대화 맥락 없이 새 질문을 하고 싶을 때 유용합니다.
/compact
대화 내용을 요약해 토큰 사용량을 줄이고 컨텍스트를 유지합니다. 장시간 작업 시 매우 유용합니다.
/review
코드 블록, PR 또는 파일을 리뷰해줍니다. 문법 오류나 스타일 문제를 빠르게 잡아내며, 피드백이 실시간으로 제공됩니다.
/help
사용 가능한 모든 명령어 목록을 보여줍니다. CLI에서 명령어를 잊었을 때 빠르게 참고할 수 있습니다.
/model
세션에서 사용할 Claude 모델(Opus 또는 Sonnet)을 선택합니다. Opus는 더 깊은 사고를, Sonnet은 빠른 응답을 제공합니다.
3. 프로젝트 이해도 상승 – 코드베이스 탐색 기능
Claude Code CLI는 단순 대화형 도우미가 아니라, 복잡한 코드베이스를 빠르게 이해하도록 도와줍니다.
> summarize this project
전체 프로젝트에 대한 요약 정보를 제공합니다. 오픈 소스 분석이나 신규 프로젝트 온보딩 시 매우 유용합니다.
> explain the folder structure
디렉토리 구조를 분석해 각 폴더의 역할을 설명합니다. 빠른 구조 파악이 가능합니다.
> find the files that handle user authentication
특정 기능을 담당하는 파일을 자동으로 찾아줍니다. 검색 기능을 넘어 실제 기능 중심으로 분석합니다.
> explain the main architecture patterns used here
코드에서 사용된 주요 설계 패턴을 분석해 설명합니다. 프로젝트에 맞는 개발 스타일을 익히는 데 유리합니다.
4. 고급 활용 – 커스텀 명령어와 자동화
보다 복잡한 작업을 자동화하려면 고급 기능을 사용할 수 있습니다.
커스텀 Slash 명령어 생성
.claude/commands 디렉토리에 마크다운 파일을 만들면 사용자 정의 명령어가 됩니다.
예시:
# .claude/commands/test.md
Run all the unit tests and report the results.
이제 /project:test 명령으로 해당 내용을 실행할 수 있습니다.
MCP 연결 – 외부 도구 제어
Playwright 등 외부 도구를 Claude와 연동하려면 아래 명령어를 사용합니다.
claude mcp add playwright npx @playwright/mcp@latest
Claude가 브라우저를 제어하여 로그인, 스크린샷, 테스트 실행 등 다양한 작업을 수행할 수 있습니다.
권한 관리
.claude/settings.json 파일을 통해 특정 명령어에 대한 허용/차단을 설정할 수 있습니다. 고급 사용자는 --dangerously-skip-permissions 옵션으로 제한을 해제할 수도 있습니다.
토큰 사용량 추적
npx ccusage@latest
현재 세션에서 소모한 토큰 수와 예상 비용을 확인할 수 있습니다.
5. AI 기반 개발 워크플로우 – Claude를 팀원처럼 활용하기
Claude Code CLI는 단순 도구를 넘어, 실제 개발 흐름에 깊이 통합될 수 있습니다.
테스트 주도 개발(TDD)
- 실패하는 테스트 생성
- 테스트 통과하는 코드 작성
- 코드 리팩토링
Claude는 테스트 코드와 구현 코드를 모두 자동으로 작성해 TDD를 더 쉽게 실천할 수 있도록 도와줍니다.
멀티 Claude 인스턴스 활용
- 인스턴스 1: 코드 작성
- 인스턴스 2: 코드 리뷰
- 인스턴스 3: 리뷰 피드백 반영 및 리팩토링
여러 Claude 인스턴스를 병렬로 사용해 실제 팀처럼 분업화된 개발이 가능합니다.
AI와 함께하는 개발의 미래
Claude Code CLI는 단순한 AI 도구가 아닙니다. 명령어 몇 줄만으로 프로젝트를 분석하고, 코드를 리뷰하며, 실제 개발 흐름에 맞춰 유기적으로 작동하는 새로운 시대의 개발 파트너입니다.
지금 이 도구를 익히면 반복적인 작업에 덜 시간을 쏟고, 창의적이고 핵심적인 작업에 더 집중할 수 있습니다. Claude Code CLI는 개발의 본질을 방해하지 않으면서도, 당신의 속도와 효율을 극대화해주는 조력자입니다.
20 Claude Code CLI Commands That Will Make You a Terminal Wizard
Let’s face it: The days of coding solo, hunched over a keyboard, are fading fast. In 2025, your best teammate might just be an AI — and if…
garysvenson09.medium.com
