Claude Code란?

Claude Code는 Anthropic이 만든 AI 코딩 에이전트로, 터미널에서 직접 코드를 편집하고, 명령을 실행하며, 전체 프로젝트를 관리한다. 200K 컨텍스트 윈도우로 대규모 코드베이스를 이해하고, 다중 파일 리팩토링, 아키텍처 설계, 디버깅을 자율적으로 수행한다. VS Code, JetBrains IDE 확장도 지원한다.

설치

# npm으로 설치 (Node.js 18+ 필요)
npm install -g @anthropic-ai/claude-code

# 또는 특정 버전 설치
npm install -g @anthropic-ai/claude-code@latest

# 실행
cd my-project
claude

# 비대화형 모드 (스크립트에서 활용)
claude -p "이 프로젝트의 README를 한국어로 번역해줘"

핵심 기능

1. 슬래시 명령어

# 대화 내에서 사용하는 슬래시 명령어
/help          # 도움말
/clear         # 대화 초기화
/compact       # 컨텍스트 압축
/cost          # 현재 세션 비용 확인
/status        # 실행 중인 에이전트/태스크 상태
/fast          # Fast Mode 토글 (같은 모델, 빠른 출력)
/memory        # 메모리 관리

2. CLAUDE.md - 프로젝트 규칙 설정

# 프로젝트 루트에 CLAUDE.md 생성
# Claude Code가 자동으로 읽어 규칙을 따름

# CLAUDE.md 예시 내용:
## 코딩 규칙
- TypeScript strict mode 사용
- 함수명은 camelCase
- 테스트는 Vitest 사용
- 커밋 메시지는 Conventional Commits

## 프로젝트 구조
- src/ : 소스 코드
- tests/ : 테스트 파일
- docs/ : 문서

3. MCP (Model Context Protocol) 서버 연동

# .claude/settings.json에 MCP 서버 설정
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/Users/dev/documents"
      ]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    }
  }
}

4. 커스텀 슬래시 명령어

# .claude/commands/deploy.md 파일 생성
# 팀 전체가 공유할 수 있는 재사용 가능한 워크플로우

# 예시: .claude/commands/review.md
이 PR의 변경사항을 리뷰해주세요:
- 보안 취약점 체크
- 성능 이슈 확인
- 코딩 컨벤션 준수 여부
- 테스트 커버리지 확인
결과를 마크다운 테이블로 정리해주세요.

# 사용: /review 입력하면 해당 프롬프트가 실행됨

5. Hooks - 이벤트 기반 자동화

# .claude/settings.json에 hooks 설정
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "command": "echo 파일 편집 시작"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "npx prettier --write $CLAUDE_FILE_PATH"
      }
    ],
    "Notification": [
      {
        "command": "terminal-notifier -message $CLAUDE_NOTIFICATION"
      }
    ]
  }
}

6. 서브에이전트와 병렬 처리

# .claude/agents/test-runner.md
---
name: test-runner
description: 테스트 실행 전문 에이전트
---
테스트를 실행하고 실패한 테스트를 분석하세요.

# 메인 Claude Code에서 에이전트 호출
# Agent tool로 독립적인 서브 프로세스 실행
# 병렬로 여러 에이전트를 동시에 실행 가능

Q1 2026 주요 업데이트

- Remote Control: 터미널 없이 원격으로 Claude Code 세션 제어
- Dispatch: API로 프로그래밍 방식으로 태스크 전송
- Computer Use: GUI 화면 캡처 및 마우스/키보드 조작
- Scheduled Tasks: cron 기반 예약 실행

비대화형 모드 활용 예시

# CI/CD 파이프라인에서 코드 리뷰 자동화
claude -p "git diff main...HEAD를 리뷰하고 문제를 보고해" --output-format json

# 파일 변환 자동화
claude -p "src/ 디렉토리의 모든 .js 파일을 .ts로 변환해"

# 문서 생성
claude -p "src/api/ 디렉토리의 모든 엔드포인트에 대해 OpenAPI 스펙을 생성해"

요금제

- Claude Pro ($20/월): 기본 사용량
- Claude Max ($100~200/월): 무제한 사용
- Teams/Enterprise: 팀 기능 + 관리 콘솔

Claude Code는 터미널 기반 AI 코딩의 새로운 표준으로, MCP를 통한 외부 도구 통합과 에이전틱 워크플로우로 개발 생산성을 크게 향상시킨다.