44. Claude Code 개요
기능 소개·환경별 설치·활용 시나리오 등 Claude Code 전체 개요 가이드
Claude Code 개요
Claude Code는 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하며, 개발 도구와 통합되는 에이전트 기반 코딩 도구입니다. 터미널, IDE, 데스크톱 앱, 브라우저에서 사용할 수 있습니다.
Claude Code는 기능 구현, 버그 수정, 개발 작업 자동화를 도와주는 AI 기반 코딩 어시스턴트입니다. 전체 코드베이스를 이해하며, 여러 파일과 도구를 넘나들며 작업을 수행할 수 있습니다.
시작하기
사용 환경을 선택하여 시작하세요. 대부분의 환경은 Claude 구독 또는 Anthropic Console 계정이 필요합니다. Terminal CLI와 VS Code는 서드파티 프로바이더도 지원합니다.
Terminal
터미널에서 Claude Code를 직접 사용할 수 있는 완전한 기능의 CLI입니다. 파일을 편집하고, 명령을 실행하며, 커맨드 라인에서 전체 프로젝트를 관리하세요.
Claude Code를 설치하려면 다음 방법 중 하나를 사용하세요:
Native Install (Recommended)
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows는 Git for Windows가 필요합니다. 설치되어 있지 않다면 먼저 설치하세요.
참고: 네이티브 설치는 백그라운드에서 자동 업데이트되어 항상 최신 버전을 유지합니다.
Homebrew
brew install --cask claude-code
참고: Homebrew 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 패치를 받으려면 주기적으로
brew upgrade claude-code를 실행하세요.
WinGet
winget install Anthropic.ClaudeCode
참고: WinGet 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 패치를 받으려면 주기적으로
winget upgrade Anthropic.ClaudeCode를 실행하세요.
그런 다음 아무 프로젝트에서나 Claude Code를 시작하세요:
cd your-project
claude
처음 사용 시 로그인하라는 안내가 표시됩니다. 이게 끝입니다! 빠른 시작 가이드로 계속하기 →
팁: 설치 옵션, 수동 업데이트 또는 제거 방법은 고급 설정을 참고하세요. 문제가 발생하면 문제 해결을 방문하세요.
VS Code
VS Code 확장은 인라인 diff, @-멘션, 계획 검토, 대화 기록을 에디터에서 직접 제공합니다.
또는 확장 뷰(Cmd+Shift+X Mac, Ctrl+Shift+X Windows/Linux)에서 "Claude Code"를 검색하세요. 설치 후 Command Palette(Cmd+Shift+P / Ctrl+Shift+P)를 열고 "Claude Code"를 입력한 다음 Open in New Tab을 선택하세요.
Desktop app
IDE나 터미널 외부에서 Claude Code를 실행할 수 있는 독립형 앱입니다. diff를 시각적으로 검토하고, 여러 세션을 나란히 실행하며, 반복 작업을 예약하고, 클라우드 세션을 시작하세요.
다운로드 및 설치:
- macOS (Intel 및 Apple Silicon)
- Windows (x64)
- Windows ARM64 (원격 세션 전용)
설치 후 Claude를 실행하고 로그인한 다음 Code 탭을 클릭하여 코딩을 시작하세요. 유료 구독이 필요합니다.
Web
로컬 설정 없이 브라우저에서 Claude Code를 실행하세요. 장시간 실행되는 작업을 시작하고 완료되면 확인하거나, 로컬에 없는 리포지토리에서 작업하거나, 여러 작업을 병렬로 실행하세요. 데스크톱 브라우저와 Claude iOS 앱에서 사용할 수 있습니다.
claude.ai/code에서 코딩을 시작하세요.
JetBrains
IntelliJ IDEA, PyCharm, WebStorm 및 기타 JetBrains IDE용 플러그인으로, 인터랙티브 diff 뷰와 선택 컨텍스트 공유를 지원합니다.
JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 재시작하세요.
할 수 있는 것들
Claude Code를 사용할 수 있는 몇 가지 방법을 소개합니다:
미루던 작업 자동화
Claude Code는 하루를 잡아먹는 지루한 작업을 처리합니다: 테스트되지 않은 코드의 테스트 작성, 프로젝트 전체의 lint 오류 수정, merge conflict 해결, 의존성 업데이트, 릴리스 노트 작성.
claude "write tests for the auth module, run them, and fix any failures"
기능 구현 및 버그 수정
원하는 것을 자연어로 설명하세요. Claude Code가 접근 방식을 계획하고, 여러 파일에 걸쳐 코드를 작성하며, 동작을 검증합니다.
버그의 경우, 오류 메시지를 붙여넣거나 증상을 설명하세요. Claude Code가 코드베이스를 추적하여 근본 원인을 파악하고 수정을 구현합니다. 더 많은 예제는 일반적인 워크플로를 참고하세요.
커밋 및 풀 리퀘스트 생성
Claude Code는 git과 직접 작동합니다. 변경 사항을 스테이징하고, 커밋 메시지를 작성하며, 브랜치를 생성하고, 풀 리퀘스트를 엽니다.
claude "commit my changes with a descriptive message"
CI에서는 GitHub Actions 또는 GitLab CI/CD로 코드 리뷰와 이슈 분류를 자동화할 수 있습니다.
MCP로 도구 연결
Model Context Protocol (MCP)은 AI 도구를 외부 데이터 소스에 연결하기 위한 오픈 표준입니다. MCP를 통해 Claude Code는 Google Drive의 설계 문서를 읽고, Jira의 티켓을 업데이트하고, Slack에서 데이터를 가져오거나, 자체 커스텀 도구를 사용할 수 있습니다.
명령어, 스킬, 훅으로 커스터마이징
CLAUDE.md는 프로젝트 루트에 추가하는 마크다운 파일로, Claude Code가 모든 세션 시작 시 읽습니다. 코딩 표준, 아키텍처 결정, 선호하는 라이브러리, 리뷰 체크리스트를 설정하는 데 사용하세요. Claude는 작업하면서 자동 메모리도 구축하여, 빌드 명령어나 디버깅 인사이트 같은 학습 내용을 별도 작성 없이 세션 간에 저장합니다.
커스텀 명령어를 만들어 /review-pr이나 /deploy-staging 같은 반복 가능한 워크플로를 팀과 공유하세요.
훅을 사용하면 Claude Code 작업 전후에 셸 명령을 실행할 수 있습니다. 예를 들어 파일 편집 후 자동 포맷팅이나 커밋 전 lint 실행 등이 가능합니다.
에이전트 팀 운영 및 커스텀 에이전트 구축
여러 Claude Code 에이전트를 생성하여 작업의 서로 다른 부분을 동시에 처리하세요. 리드 에이전트가 작업을 조율하고, 하위 작업을 할당하며, 결과를 병합합니다.
완전한 커스텀 워크플로를 위해 Agent SDK를 사용하면 Claude Code의 도구와 기능을 활용하여 오케스트레이션, 도구 접근, 권한을 완전히 제어하는 자체 에이전트를 구축할 수 있습니다.
파이프, 스크립트, CLI를 통한 자동화
Claude Code는 조합 가능하며 Unix 철학을 따릅니다. 로그를 파이프로 전달하고, CI에서 실행하거나, 다른 도구와 체이닝하세요:
# 로그 모니터링 및 알림 받기
tail -f app.log | claude -p "Slack me if you see any anomalies"
# CI에서 번역 자동화
claude -p "translate new strings into French and raise a PR for review"
# 파일 전반에 걸친 대량 작업
git diff main --name-only | claude -p "review these changed files for security issues"
전체 명령어와 플래그는 CLI 레퍼런스를 참고하세요.
어디서나 작업
세션은 단일 환경에 묶이지 않습니다. 상황에 따라 환경 간에 작업을 이동하세요:
- 자리를 비우고 휴대폰이나 아무 브라우저에서 Remote Control로 계속 작업하세요
- 웹이나 iOS 앱에서 장시간 실행 작업을 시작한 다음
/teleport로 터미널로 가져오세요 /desktop으로 터미널 세션을 데스크톱 앱으로 전달하여 시각적 diff 검토를 하세요- 팀 채팅에서 작업을 라우팅하세요: Slack에서
@Claude를 멘션하여 버그 리포트를 보내면 풀 리퀘스트를 받을 수 있습니다
어디서든 Claude Code 사용
각 환경은 동일한 Claude Code 엔진에 연결되므로, CLAUDE.md 파일, 설정, MCP 서버가 모든 환경에서 동작합니다.
위의 Terminal, VS Code, JetBrains, Desktop, Web 환경 외에도 Claude Code는 CI/CD, 채팅, 브라우저 워크플로와 통합됩니다:
| 하고 싶은 것 | 최적의 옵션 |
|---|---|
| 로컬 세션을 휴대폰이나 다른 기기에서 이어서 작업 | Remote Control |
| 로컬에서 작업을 시작하고 모바일에서 이어서 작업 | Web 또는 Claude iOS 앱 |
| PR 리뷰 및 이슈 분류 자동화 | GitHub Actions 또는 GitLab CI/CD |
| Slack의 버그 리포트를 풀 리퀘스트로 라우팅 | Slack |
| 실시간 웹 애플리케이션 디버깅 | Chrome |
| 자체 워크플로를 위한 커스텀 에이전트 구축 | Agent SDK |
다음 단계
Claude Code를 설치한 후, 다음 가이드를 통해 더 깊이 알아보세요.
- 빠른 시작: 코드베이스 탐색부터 수정 사항 커밋까지 첫 번째 실제 작업을 따라해 보세요
- 명령어 및 메모리 저장: CLAUDE.md 파일과 자동 메모리로 Claude에게 지속적인 지시를 제공하세요
- 일반적인 워크플로 및 모범 사례: Claude Code를 최대한 활용하기 위한 패턴
- 설정: 워크플로에 맞게 Claude Code를 커스터마이징하세요
- 문제 해결: 일반적인 문제에 대한 솔루션
- code.claude.com: 데모, 가격, 제품 상세 정보