Claude Code 개요

Claude Code 개요

Claude Code는 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하며 개발 도구와 연동하는 에이전틱 코딩 도구입니다. 터미널, IDE 확장, 데스크톱 앱, 웹 어디서든 쓸 수 있고, 모든 서피스가 같은 엔진을 공유합니다. 기능을 만들고, 버그를 고치고, 개발 작업을 자동화하는 데 쓰입니다.

출처: 공식문서

본문

Claude Code는 AI 기반 코딩 어시스턴트로, 기능 구축·버그 수정·개발 태스크 자동화를 돕습니다. 전체 코드베이스를 이해하고 여러 파일과 도구에 걸쳐 작업을 처리합니다.

시작하기

Claude Code는 터미널, IDE 확장, 데스크톱 앱, 웹 등 여러 서피스에서 실행됩니다. 아래 탭에서 원하는 곳을 골라 시작하세요. 대부분의 서피스는 Claude 구독 또는 Anthropic Console 계정이 필요합니다. 터미널 CLI, VS Code, JetBrains는 서드파티 프로바이더도 지원합니다.

터미널 — Claude Code를 터미널에서 직접 쓸 수 있는 풀기능 CLI입니다. 설치는 다음 방법 중 하나로 합니다.

  • 네이티브 설치(권장)

    • 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
      The token '&&' is not a valid statement separator가 보이면 현재 PowerShell이 아니라 CMD입니다. 'irm' is not recognized as an internal or external command가 보이면 CMD가 아니라 PowerShell입니다. 프롬프트가 PS C:\로 시작하면 PowerShell, C:\로 시작하면 CMD입니다. 설치가 syntax error near unexpected token '<', 403, 또는 다른 curl 오류로 실패하면 Troubleshoot installation에서 오류에 맞는 해결책을 찾으세요. 네이티브 Windows에서는 Claude Code가 Bash 도구를 쓸 수 있도록 Git for Windows를 권장합니다. 설치되지 않았다면 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL은 Git for Windows가 필요 없습니다. 네이티브 설치는 백그라운드에서 자동 업데이트되어 항상 최신 버전을 유지합니다.

  • Homebrew:

    brew install --cask claude-code

    두 개의 cask가 있습니다. claude-code는 안정 릴리스 채널을 따르며 보통 일주일가량 뒤처지고 큰 회귀가 있는 릴리스를 건너뜁니다. claude-code@latest는 최신 채널을 따라 새 버전이 나오는 즉시 받습니다. Homebrew 설치는 자동 업데이트되지 않으니 설치한 cask에 따라 brew upgrade claude-code 또는 brew upgrade claude-code@latest로 업데이트하세요.

  • WinGet:

    winget install Anthropic.ClaudeCode

    WinGet도 자동 업데이트되지 않으니 주기적으로 winget upgrade Anthropic.ClaudeCode를 실행해 최신 기능과 보안 수정을 받으세요.

Debian/Fedora/RHEL/Alpine에서는 apt, dnf, apk로도 설치할 수 있습니다. 그다음 어떤 프로젝트에서든 시작합니다:

cd your-project
claude

첫 사용 시 로그인을 요청합니다. ANTHROPIC_API_KEY 환경변수를 설정했다면 로그인 프롬프트를 건너뛰고 대신 키 승인을 요청합니다. 이제 Quickstart →로 계속 진행하세요.

VS Code — VS Code 확장은 인라인 diff, @-멘션, 플랜 리뷰, 대화 기록을 에디터 안에서 제공합니다.

Extensions 뷰(Mac Cmd+Shift+X, Windows/Linux Ctrl+Shift+X)에서 "Claude Code"를 검색해도 됩니다. 설치 후 Command Palette(Cmd+Shift+P / Ctrl+Shift+P)를 열어 "Claude Code"를 입력하고 Open in New Tab을 선택하세요.

데스크톱 앱 — IDE나 터미널 밖에서 Claude Code를 실행하는 독립 앱입니다. diff를 시각적으로 리뷰하고, 여러 세션을 나란히 실행하며, 반복 작업을 예약하고, 클라우드 세션을 시작할 수 있습니다.

설치 후 Claude를 실행해 로그인하고 Code 탭을 클릭하면 코딩을 시작합니다. 앱에 Claude Code가 포함되어 있어 CLI를 별도로 설치할 필요는 없습니다. 유료 구독이 필요합니다.

웹 — 로컬 설정 없이 브라우저에서 Claude Code를 실행합니다. 오래 걸리는 태스크를 시작해 두고 완료를 확인하고, 로컬에 없는 레포에서 작업하거나 여러 태스크를 병렬로 실행합니다. 데스크톱 브라우저와 iOS/Android용 Claude 앱에서 사용 가능합니다. claude.ai/code에서 시작하세요.

JetBrains — IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE용 플러그인으로 인터랙티브 diff 보기와 선택 컨텍스트 공유를 제공합니다. JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 재시작하세요. 플러그인은 별도로 설치한 Claude Code CLI가 필요합니다.

할 수 있는 일

  • 미루던 작업 자동화 — 테스트가 없는 코드에 테스트 작성, 프로젝트 전반의 lint 오류 수정, 머지 충돌 해결, 의존성 업데이트, 릴리스 노트 작성 같은 지루한 작업을 처리합니다. 
    claude "write tests for the auth module, run them, and fix any failures"
  • 기능 구축·버그 수정 — 원하는 것을 자연어로 설명하면 Claude Code가 접근 방식을 계획하고 여러 파일에 걸쳐 코드를 작성한 뒤 동작을 검증합니다. 버그는 에러 메시지를 붙여넣거나 증상을 설명하세요. common workflows에 더 많은 예시가 있습니다.
  • 커밋·풀 리퀘스트 생성 — git과 직접 연동해 변경을 스테이징하고 커밋 메시지를 쓰고 브랜치를 만들며 PR을 엽니다. 
    claude "commit my changes with a descriptive message"
    CI에서는 GitHub Actions나 GitLab CI/CD로 코드 리뷰와 이슈 트리아지를 자동화할 수 있습니다.
  • MCP로 도구 연결 — Model Context Protocol(MCP)은 AI 도구를 외부 데이터 소스에 연결하는 오픈 표준입니다. Google Drive 설계 문서를 읽고, Jira 티켓을 갱신하며, Slack 데이터를 가져오거나 커스텀 도구를 씁니다. MCP quickstart로 첫 서버를 엔드투엔드로 연결하세요.
  • CLAUDE.md·스킬·훅으로 커스터마이즈 — CLAUDE.md는 프로젝트 루트에 두는 마크다운 파일로, 매 세션 시작 시 Claude Code가 읽습니다. 코딩 표준·아키텍처 결정·선호 라이브러리·리뷰 체크리스트를 적습니다. Claude는 작업하며 자동 메모리도 쌓아 여러 세션에 걸친 학습을 저장합니다. /review-pr, /deploy-staging 같은 재사용 가능한 워크플로를 스킬로 묶을 수 있고, 훅으로 파일 편집 후 자동 포맷이나 커밋 전 lint 등 셸 명령을 실행할 수 있습니다.
  • 에이전트 병렬 실행·커스텀 에이전트 구축 — 태스크의 다른 부분을 동시에 작업하는 여러 Claude Code 에이전트를 띄웁니다. 리드 에이전트가 작업을 조정하고 서브태스크를 배정하며 결과를 병합합니다. 여러 세션을 병렬로 실행하고 한 화면에서 보려면 background agents를, 완전한 커스텀 워크플로는 Agent SDK를 사용하세요.
  • CLI로 파이프·스크립트·자동화 — Claude Code는 조합 가능하며 Unix 철학을 따릅니다. 
    # 최근 로그 출력 분석
tail -200 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"
  • 반복 작업 예약 — 아침 PR 리뷰, 밤새 CI 실패 분석, 주간 의존성 감사 등 반복 작업을 스케줄로 돌립니다. Routines은 클라우드에서 실행되어 컴퓨터가 꺼져도 계속 돌고 API 호출·GitHub 이벤트로도 트리거됩니다. Desktop scheduled tasks는 로컬 파일·도구에 직접 접근해 내 컴퓨터에서 실행되고, /loop는 CLI 세션 안에서 빠른 폴링용 프롬프트를 반복합니다.
  • 어디서든 작업 — 세션은 한 서피스에 묶이지 않습니다. Remote Control로 폰·브라우저에서 이어가고, 웹이나 Claude 모바일 앱에서 긴 태스크를 시작해 claude --teleport로 터미널로 가져오며, /desktop으로 현재 세션을 데스크톱 앱에서 이어서 diff를 시각적으로 리뷰합니다.

어디서나 사용하기

각 서피스는 같은 Claude Code 엔진에 연결되므로 레포의 CLAUDE.md, 설정, MCP 서버가 어디서든 그대로 동작합니다. CI/CD, 채팅, 브라우저 워크플로와도 연동됩니다.

하고 싶은 것 최선의 선택
폰·다른 기기에서 로컬 세션 이어가기 Remote Control
Telegram·Discord·iMessage·자체 웹훅 이벤트를 세션에 밀어넣기 Channels
로컬에서 시작, 모바일에서 이어가기 claude --cloud 후 Claude 모바일 앱
반복 스케줄로 Claude 실행 Routines 또는 Desktop scheduled tasks
PR 리뷰·이슈 트리아지 자동화 GitHub Actions 또는 GitLab CI/CD
모든 PR에 자동 코드 리뷰 받기 GitHub Code Review
Slack 버그 리포트를 PR로 연결 Slack
라이브 웹앱 디버깅 Chrome
자체 워크플로용 커스텀 에이전트 구축 Agent SDK

다음 단계

설치 후 이 가이드들이 더 깊이 들어가는 데 도움이 됩니다. Quickstart로 첫 실제 태스크를, CLAUDE.md·메모리 저장, Common workflows와 best practices, Settings, Troubleshooting을 참고하세요.

더 알아보기