Claude Code — Anthropic의 에이전트형 AI 코딩 도구

GitHub: https://github.com/anthropics/claude-code

개요

Claude Code는 Anthropic에서 개발한 에이전트형 코딩 도우미로, 터미널(및 IDE)에서 직접 실행됩니다. 기존의 자동 완성 도구와 달리 Claude Code는 전체 코드베이스의 맥락을 이해하고 파일 읽기, 코드 편집, bash 명령어 실행, git 워크플로우 관리 등 자율적인 다단계 작업을 수행할 수 있습니다. 이 모든 작업은 자연어 지시에 의해 구동됩니다.

Anthropic의 Claude 모델(기본값: Claude Sonnet)로 구동되며 Claude API, Amazon Bedrock, Google Vertex AI 및 Microsoft Foundry와의 통합을 지원합니다.

주요 기능

🧠 코드베이스 이해

Claude Code는 프로젝트 파일을 읽고 탐색하며, 아키텍처를 이해하고, 맥락에 맞는 제안 및 편집을 제공합니다. cat 또는 sed와 같은 셸 명령에 의존하는 대신 전용 도구(Read, Edit, Glob, Grep)를 사용하여 파일과 상호 작용합니다.

💬 자연어 인터페이스

일반 영어(또는 다른 언어)를 사용하여 Claude Code와 상호 작용할 수 있습니다. 명령어를 외울 필요 없이 원하는 것을 설명하면 Claude Code가 단계를 파악합니다.

🔄 Git 워크플로우 자동화

Claude Code는 브랜치 생성, 변경 사항 커밋, 커밋 메시지 작성, 심지어 풀 리퀘스트 열기까지 전체 git 워크플로우를 자연어를 통해 처리할 수 있습니다.

🖥️ 다중 인터페이스 지원

터미널 — 기본 인터페이스로, 모든 프로젝트 디렉토리에서 claude를 실행합니다.
VS Code / Cursor / JetBrains — 사이드바 패널 지원이 포함된 IDE 확장 프로그램
GitHub Actions — PR 또는 이슈에서 @claude를 태그하여 자동 코드 검토, 구현 또는 버그 수정을 트리거합니다.

🔌 플러그인 및 MCP 지원

Claude Code는 Model Context Protocol (MCP) 서버를 지원하여 외부 도구 및 데이터 소스를 동적으로 통합할 수 있습니다. 공식 플러그인 레지스트리(anthropics/claude-plugins-official)는 고품질 커뮤니티 플러그인을 큐레이션합니다.

🎙️ 음성 모드

영어, 러시아어, 일본어, 중국어 등 20개 이상의 언어를 지원하는 음성 STT(음성-텍스트) 인터페이스를 사용할 수 있습니다.

🔒 보안 검토

내장된 /security-review 슬래시 명령(및 동반 GitHub Action)은 OWASP와 일치하는 보안 분석을 코드 변경 사항에 대해 수행하여 주입 공격, 인증 문제, 데이터 노출 및 암호화 약점을 표시합니다.

⚙️ 스크립팅 및 자동화 (`--bare` 플래그)

CI/CD 파이프라인 및 헤드리스 자동화를 위해 --bare 플래그는 대화형 기능을 비활성화하고 Claude Code를 스크립트 API 클라이언트로만 실행합니다. ANTHROPIC_API_KEY 기반 인증과 호환됩니다.

설치

# 권장: npm을 통해 전역으로 설치
npm install -g @anthropic-ai/claude-code

# 프로젝트로 이동하여 시작
cd your-project
claude

참고: npm 설치는 플랫폼별 설치 프로그램을 선호하여 단계적으로 폐지되고 있습니다. 최신 권장 설치 방법은 공식 설정 문서를 참조하십시오.

작동 방식

Claude Code는 핵심 Claude API 에이전트 루프를 프로덕션 등급의 하네스로 감쌉니다.

사용자 입력 → Claude API (claude-sonnet) → 도구 사용 결정
                    ↓
          도구 실행 (Read / Edit / Bash / Git / MCP)
                    ↓
          결과 추가 → 작업 완료 시까지 반복

에이전트는 파일 읽기/쓰기, bash 실행, glob 검색, grep, git 작업 및 MCP 연결 외부 도구를 포함한 40개 이상의 내장 도구를 사용할 수 있습니다.

GitHub Actions 통합

Claude Code는 anthropics/claude-code-action을 통해 GitHub와 통합됩니다.

PR 댓글 또는 이슈에서 @claude를 태그하여 Claude를 트리거합니다.
Claude는 질문에 답하고, 코드를 검토하고, 기능을 구현하고, PR을 열 수 있습니다.
백엔드로 Anthropic API, AWS Bedrock, Google Vertex AI 및 Microsoft Foundry를 지원합니다.

예제 워크플로우 트리거:

@claude 이 함수를 더 읽기 쉽게 리팩터링하고 단위 테스트를 추가해 주세요.

데이터 및 개인 정보 보호

Claude Code를 사용할 때 Anthropic은 다음을 수집합니다.

사용 데이터(코드 수락/거부)
관련 대화 데이터
/bug를 통해 제출된 버그 보고서

Anthropic은 민감한 정보에 대해 제한된 보존 기간을 적용하며, 동의 없이 모델 학습에 이 피드백을 사용하지 않습니다.

생태계

리포지토리	설명
`anthropics/claude-code`	핵심 CLI 도구
`anthropics/claude-code-action`	GitHub Actions 통합
`anthropics/claude-code-security-review`	AI 기반 보안 검토 액션
`anthropics/claude-plugins-official`	공식 큐레이션 플러그인 디렉토리
`anthropics/claude-quickstarts`	Claude API를 사용하는 시작 프로젝트

커뮤니티

💬 Claude Developers Discord
🐛 Claude Code 내에서 /bug를 사용하거나 GitHub Issues를 통해 버그를 보고하세요.
📖 공식 문서

요약

Claude Code는 단순한 코드 자동 완성 도구를 넘어, 완전히 에이전트화된 소프트웨어 엔지니어링 도우미로서 다단계 코딩 작업을 자율적으로 계획, 실행 및 반복할 수 있습니다. 터미널, IDE 및 GitHub와의 긴밀한 통합은 개인 개발자와 엔터프라이즈 CI/CD 파이프라인 모두에 적합합니다.

claude-code