TL;DR
Claude Code는 터미널 네이티브 AI 에이전트입니다. 비대화형 + 구조화된 출력 + 명확한 종료 코드를 갖춘 CLI 도구를 갖추면 생산성이 확 달라져요. 이 글에서 30개 도구를 카테고리별로 정리합니다.
왜 Claude Code + CLI인가
Claude Code를 쓰면서 하나 깨달은 게 있어요. 이 AI 에이전트는 터미널에서 살아요. Bash 도구로 모든 CLI 명령을 직접 실행하죠.
Anthropic 공식 문서에서도 이렇게 말합니다:
"Tell Claude Code to use CLI tools like gh, aws, gcloud, and sentry-cli when interacting with external services. CLI tools are the most context-efficient way to interact with external services."
그래서 어떤 CLI 도구를 물려주느냐가 곧 생산성의 차이를 만들어요.
Claude Code 친화적 CLI의 조건
- 비대화형(Non-interactive): TUI 없이 한 줄 명령으로 실행
- 구조화된 출력: JSON, CSV 등 파싱 가능한 포맷
- 명확한 종료 코드: 성공(0)/실패(1) 판별
- 조합 가능(Composable): 파이프, 리다이렉션과 잘 작동
- 멱등성: 같은 명령 = 같은 결과
- 좋은 --help: Claude가 옵션을 스스로 파악 가능
코어 명령어 현대화
매일 쓰는 기본 명령어들이 Rust로 재작성되면서 속도와 사용성이 좋아졌어요.
| 기존 | 대체 | 핵심 장점 |
|---|---|---|
| ls | eza | 색상, Git 통합, 트리뷰 |
| cat | bat | 구문 강조, Git diff, 줄번호 |
| find | fd | 직관적 문법, .gitignore 존중 |
| grep | ripgrep(rg) | 멀티코어 병렬 검색, 10배+ 빠름 |
| sed | sd | 직관적 find/replace |
| diff | delta | Git diff 구문 강조, side-by-side |
특히 ripgrep은 Claude Code 내장 Grep 도구의 백엔드이기도 해요. 이미 쓰고 있는 셈이죠.
brew install ripgrep fd bat eza sd delta
데이터 처리 & API 도구
API 응답을 파싱하고, HTTP 요청을 보내는 도구들이에요.
- jq: JSON 파싱/필터/변환의 핵심. Claude가 jq 필터 작성에 매우 능숙
- yq: YAML/TOML 파싱. Kubernetes 매니페스트, CI 설정 처리
- httpie: curl보다 직관적인 HTTP 클라이언트
- curl: 범용 HTTP 클라이언트. Claude가 가장 익숙한 도구
Claude Code의 데이터 파이프라인 기본 패턴은 이거예요:
curl -s https://api.example.com/data | jq '.results[] | {name, score}'
Git & GitHub 자동화
gh CLI가 Claude Code와 최고 궁합을 자랑해요. Anthropic 공식 권장 도구이기도 하고요.
비대화형 + JSON 출력 + GitHub 자동화 세 박자가 맞기 때문이에요:
# PR 목록을 JSON으로 조회
gh pr list --json number,title,state
# 이슈 생성
gh issue create --title "Bug fix" --body "Description"
# Actions 실행 상태 확인
gh run list --limit 5
코드 검색 & 리팩토링
ast-grep (sg): AST 패턴 기반 구조적 코드 검색/리팩토링이에요. 정규식이 아닌 코드 구조를 이해하는 검색.
커뮤니티에서 "하나만 설치한다면 이것"이라고 평가받는 도구예요.
difftastic: AST 기반 diff. 공백이나 포매팅 변경은 무시하고 의미 있는 변경만 표시해요.
코드 품질 & 패키지 관리
린팅/포매팅:
| 도구 | 대상 | 용도 |
|---|---|---|
| shellcheck | Shell | 셸 스크립트 린터 |
| shfmt | Shell | 셸 스크립트 포매터 |
| ruff | Python | 린터+포매터 (초고속) |
| oxlint | JS/TS | JavaScript 린터 |
패키지 매니저:
| 도구 | 생태계 | 핵심 장점 |
|---|---|---|
| uv | Python | pip 대비 10-100배 빠름 |
| pnpm | Node.js | 디스크 효율적 |
| bun | Node.js | 런타임 겸용 올인원 |
클라우드 & 인프라
docker, supabase, terraform, kubectl. 전부 비대화형이고 JSON 출력을 지원해요.
# terraform plan 결과를 Claude가 분석
terraform plan -out=plan.tfplan
aws, gcloud, vercel도 마찬가지. Anthropic 공식 권장 도구 목록에 다 들어있어요.
미디어 & 문서 변환
- ffmpeg: 미디어 변환. 복잡한 옵션을 Claude가 한 줄로 조합
- yt-dlp: YouTube 자막 추출에 필수
- pandoc: 문서 변환 (Markdown -> DOCX -> PDF)
베스트 프랙티스
Anthropic 엔지니어들의 실전 패턴 5가지예요:
- Explore -> Plan -> Code -> Commit: CLI 도구로 탐색(rg, fd) -> 계획 -> 코드 -> 커밋
- 서브에이전트 활용: 복잡한 CLI 작업은 서브에이전트에 위임
-
JSON 출력 우선:
--format json으로 구조화된 데이터 확보 -
파이프 체인:
command | jq '.field'패턴 -
비대화형 모드 강제:
--yes,--no-interactive
# 데이터 파이프라인
curl -s API_URL | jq '.data[]' | xargs -I{} echo {}
# 파일 조작
fd -e ts | xargs rg "deprecated_function"
원라이너 설치
# 코어 + 코드 품질
brew install ripgrep fd ast-grep jq yq shellcheck shfmt difftastic bat eza gh
# Python 생태계
brew install uv ruff
마무리
Claude Code의 힘은 터미널에서 나와요. 비대화형, 구조화된 출력, 조합 가능성. 이 세 가지를 갖춘 CLI 도구를 물려주면 생산성의 차이를 체감하게 됩니다.
어떤 CLI 도구부터 시작할지 고민이면 ripgrep, fd, jq, gh 이 4개만 먼저 설치해보세요.
참고 자료:
Top comments (0)