Claude Code 터미널 워크플로우: 개발자를 위한 완전 가이드

요약

Claude Code의 CLI는 강력한 터미널 기반 AI 코딩을 제공합니다. npm으로 설치하고, 인증하고, 자연어 명령으로 코딩을 시작하세요. 에이전트 모드는 멀티 스텝 작업을 자율적으로 처리합니다. MCP는 Git, 데이터베이스, Slack 등 외부 도구에 연결합니다.

설치

# 전역 설치
npm install -g @anthropic-ai/claude-code

# 인증
claude-code auth login

# 설치 확인
claude-code --version

기본 사용법

# 대화형 세션 시작
claude-code

# 단일 명령
claude-code "이 함수 설명해줘"

# 파일 컨텍스트와 함께
claude-code "main.py 오류 처리 개선을 위해 리팩토링"

# 모델 지정
claude-code --model opus "복잡한 아키텍처 질문"

필수 명령어

명령어	설명

claude-code

대화형 세션 시작

claude-code auth

인증 관리

claude-code config

설정 구성

claude-code mcp

MCP 서버 관리

claude-code history

대화 기록 보기

에이전트 모드

에이전트 모드는 자율적 멀티 스텝 작업 실행을 가능하게 합니다:

# 에이전트 모드 활성화
claude-code --agent "테스트와 함께 사용자 인증 구현"

# 에이전트가 수행할 작업:
# 1. 기존 코드베이스 분석
# 2. 필요한 파일 생성
# 3. 기능 구현
# 4. 테스트 작성
# 5. 테스트 실행 및 실패 수정
# 6. 변경 사항 커밋

MCP 통합

Claude Code를 외부 도구에 연결:

# MCP 서버 설정
claude-code mcp add git --repo /path/to/repo
claude-code mcp add postgres --connection "postgres://..."
claude-code mcp add slack --token "xoxb-..."

# 대화에서 사용
"git 상태 확인하고 이 변경 사항에 대한 PR 생성"
"비활성 계정에 대해 users 테이블 쿼리"
"#engineering에 배포 상태 게시"

Git 워크플로우

# 자연어 git
claude-code "어떤 파일이 변경되었는지 확인"
claude-code "인증을 위한 기능 브랜치 생성"
claude-code "설명적인 메시지로 커밋"
claude-code "요약과 함께 PR 생성"

# 리뷰 워크플로우
claude-code "diff를 검토하고 개선 사항 제안"
claude-code "스테이징된 변경 사항에서 잠재적 버그 찾기"

설정

# ~/.claude-code/config.json
{
  "default_model": "sonnet-5",
  "max_tokens": 4096,
  "agent_mode": false,
  "mcp_servers": [
    {"name": "git", "command": "mcp-server-git"}
  ],
  "safety_confirmations": true
}

생산성 팁

• 별칭 사용: alias cc='claude-code'
• 파이프 입력: cat file.py | claude-code "이것 설명해줘"
• 파일로 출력: claude-code "테스트 생성" > tests.py
• 세션 유지: claude-code --continue
• 조용한 모드: claude-code -q "간단한 질문"

Codex CLI 대비

기능	Claude Code	Codex CLI

에이전트 모드

내장

제한적

MCP 지원

광범위

없음

컨텍스트 창

200K

128K

속도

보통

빠름

Git 통합

네이티브

기본

결론

Claude Code의 터미널 워크플로우는 IDE 기반 도구에 대한 강력한 대안을 제공합니다. 에이전트 모드, MCP 통합, 자연어 명령의 조합은 CLI 애호가에게 효율적인 개발 경험을 만들어줍니다.