Claude Code 개요

Claude Code는 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하며, 여러분의 개발 도구와 통합되는 에이전트형 코딩 도구입니다. 터미널, IDE, 데스크톱 앱, 브라우저에서 사용할 수 있습니다.

Claude Code는 기능 개발, 버그 수정, 개발 작업 자동화를 돕는 AI 기반 코딩 어시스턴트입니다. 코드베이스 전체를 이해하며, 여러 파일과 도구를 넘나들며 작업을 처리합니다.

시작하기

먼저 사용할 환경을 고르세요. 대부분의 환경은 Claude 구독 또는 Anthropic Console 계정이 필요합니다. 터미널 CLI와 VS Code는 서드파티 제공자도 지원합니다.

터미널

터미널에서 Claude Code를 직접 다루는 풀 기능 CLI입니다. 파일을 편집하고, 명령을 실행하며, 명령줄에서 프로젝트 전체를 관리할 수 있습니다.

Claude Code를 설치하려면 다음 방법 중 하나를 사용하세요.

네이티브 설치 (권장)

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라는 메시지가 보이면 CMD가 아니라 PowerShell에 있는 것입니다. 'irm' is not recognized as an internal or external command라는 메시지가 보이면 PowerShell이 아니라 CMD에 있는 것입니다. PowerShell에서는 프롬프트에 PS C:\가 표시되고, CMD에서는 PS 없이 C:\만 표시됩니다.

설치 명령이 syntax error near unexpected token '<', 403, 또는 다른 curl 오류로 실패하면, 설치 문제 해결 문서를 참고해 오류에 맞는 해결책과 대체 설치 방법을 확인하세요.

네이티브 Windows에서는 Claude Code가 Bash 도구를 사용할 수 있도록 Git for Windows 설치를 권장합니다. Git for Windows가 설치되어 있지 않으면 Claude Code는 셸 도구로 PowerShell을 대신 사용합니다. WSL 환경에서는 Git for Windows가 필요하지 않습니다.

네이티브 설치본은 백그라운드에서 자동으로 업데이트되어 항상 최신 버전을 유지합니다.

Homebrew

brew install --cask claude-code

Homebrew에는 두 가지 cask가 있습니다. claude-code는 안정 릴리스 채널을 따르며, 보통 약 일주일 정도 뒤처지고 큰 회귀(regression)가 있는 릴리스는 건너뜁니다. 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로도 설치할 수 있습니다.

그런 다음 아무 프로젝트에서나 Claude Code를 시작하세요.

cd your-project
claude

처음 실행하면 로그인 안내가 나타납니다. 이것으로 끝입니다! 퀵스타트로 이어서 진행하세요 →

설치 옵션, 수동 업데이트, 제거 방법은 고급 설정을 참고하세요. 문제가 생기면 설치 문제 해결 문서를 확인하세요.

VS Code

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

• VS Code용 설치
• Cursor용 설치

또는 확장 보기(Mac은 Cmd+Shift+X, Windows/Linux는 Ctrl+Shift+X)에서 "Claude Code"를 검색하세요. 설치 후 명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)를 열고 "Claude Code"를 입력한 뒤 Open in New Tab을 선택하세요.

VS Code로 시작하기 →

데스크톱 앱

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

다운로드 및 설치:

• macOS (Intel 및 Apple Silicon)
• Windows (x64)
• Windows ARM64

설치 후 Claude를 실행해 로그인하고 Code 탭을 클릭하면 코딩을 시작할 수 있습니다. 유료 구독이 필요합니다.

데스크톱 앱에 대해 더 알아보기 →

웹

로컬 설정 없이 브라우저에서 Claude Code를 실행하세요. 오래 걸리는 작업을 시작해 두고 끝나면 다시 확인하거나, 로컬에 없는 저장소에서 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다. 데스크톱 브라우저와 Claude iOS 앱에서 사용할 수 있습니다.

claude.ai/code에서 코딩을 시작하세요.

웹에서 시작하기 →

JetBrains

IntelliJ IDEA, PyCharm, WebStorm을 비롯한 JetBrains IDE용 플러그인으로, 대화형 diff 보기와 선택 영역 컨텍스트 공유를 제공합니다.

JetBrains 마켓플레이스에서 Claude Code 플러그인을 설치하고 IDE를 재시작하세요. 이 플러그인은 별도로 설치하는 Claude Code CLI가 필요합니다. JetBrains 설정 단계를 참고하세요.

JetBrains로 시작하기 →

무엇을 할 수 있나요

Claude Code를 활용하는 몇 가지 방법을 소개합니다.

자꾸 미뤄 두던 일을 자동화하기

Claude Code는 하루를 잡아먹는 번거로운 작업을 처리합니다. 테스트가 없는 코드에 테스트를 작성하고, 프로젝트 전체의 lint 오류를 고치고, 머지 충돌을 해결하고, 의존성을 업데이트하고, 릴리스 노트를 작성하는 일을 맡길 수 있습니다.

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에서 데이터를 가져오고, 여러분이 직접 만든 도구를 사용할 수 있습니다. MCP 퀵스타트에서 첫 번째 서버를 처음부터 끝까지 연결해 보세요.

인스트럭션, 스킬, 훅으로 커스터마이즈하기

CLAUDE.md는 프로젝트 루트에 추가하는 마크다운 파일로, Claude Code가 매 세션 시작 시 읽어 들입니다. 코딩 표준, 아키텍처 결정, 선호하는 라이브러리, 리뷰 체크리스트를 설정하는 데 활용하세요. 또한 Claude는 작업하면서 빌드 명령이나 디버깅 인사이트 같은 학습 내용을 자동으로 메모리에 저장하며, 여러분이 따로 적어 두지 않아도 세션 간에 이를 유지합니다.

스킬을 만들면 /review-pr나 /deploy-staging처럼 팀이 공유할 수 있는 반복 워크플로를 묶어 둘 수 있습니다.

훅을 사용하면 Claude Code 동작 전후에 셸 명령을 실행할 수 있습니다. 예를 들어 파일을 편집할 때마다 자동으로 포매팅하거나, 커밋 전에 lint를 실행하도록 할 수 있습니다.

에이전트 팀 운영과 커스텀 에이전트 구축

여러 Claude Code 에이전트를 띄워 한 작업의 서로 다른 부분을 동시에 처리하게 할 수 있습니다. 리드 에이전트가 작업을 조율하고, 하위 작업을 배정하고, 결과를 병합합니다.

여러 개의 전체 세션을 병렬로 실행하면서 한 화면에서 지켜보려면 백그라운드 에이전트를 사용하세요. 완전히 맞춤화된 워크플로를 원한다면, Agent SDK로 Claude Code의 도구와 기능을 기반으로 자신만의 에이전트를 구축할 수 있으며, 오케스트레이션, 도구 접근, 권한을 온전히 제어할 수 있습니다.

CLI로 파이프, 스크립트, 자동화하기

Claude Code는 조합 가능하며 Unix 철학을 따릅니다. 로그를 파이프로 넣거나, CI에서 실행하거나, 다른 도구와 체이닝할 수 있습니다.

# 최근 로그 출력 분석
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"

전체 명령과 플래그는 CLI 레퍼런스를 참고하세요.

반복 작업 예약하기

되풀이되는 일을 자동화하도록 Claude를 일정에 맞춰 실행하세요. 아침 PR 리뷰, 야간 CI 실패 분석, 주간 의존성 점검, PR 머지 후 문서 동기화 등이 그 예입니다.

• 루틴(Routines)은 Anthropic이 관리하는 인프라에서 실행되므로, 컴퓨터를 꺼 두어도 계속 돌아갑니다. API 호출이나 GitHub 이벤트로 트리거할 수도 있습니다. 웹, 데스크톱 앱, 또는 CLI에서 /schedule을 실행해 만들 수 있습니다.
• 데스크톱 예약 작업은 여러분의 컴퓨터에서 실행되며, 로컬 파일과 도구에 직접 접근합니다.
• /loop은 빠른 폴링을 위해 CLI 세션 안에서 프롬프트를 반복합니다.

어디서든 작업하기

세션은 하나의 환경에 묶이지 않습니다. 상황이 바뀌면 작업을 환경 사이로 옮길 수 있습니다.

• 자리를 비우더라도 Remote Control로 휴대폰이나 아무 브라우저에서 계속 작업하세요.
• Message Dispatch로 휴대폰에서 작업을 보내고, 거기서 생성된 데스크톱 세션을 여세요.
• 웹이나 iOS 앱에서 오래 걸리는 작업을 시작한 뒤 claude --teleport로 터미널로 끌어오세요. Teleport에는 claude.ai 구독이 필요합니다.
• /desktop으로 터미널 세션을 데스크톱 앱에 넘겨 시각적으로 diff를 검토하세요.
• 팀 채팅에서 작업을 라우팅하세요. Slack에서 @Claude를 멘션하고 버그 리포트를 보내면 풀 리퀘스트로 돌려받습니다.

Claude Code를 어디서나 사용하기

각 환경은 동일한 Claude Code 엔진에 연결되므로, 여러분의 CLAUDE.md 파일, 설정, MCP 서버가 모든 환경에서 그대로 동작합니다.

위에서 소개한 터미널, VS Code, JetBrains, 데스크톱, 웹 환경 외에도 Claude Code는 CI/CD, 채팅, 브라우저 워크플로와 통합됩니다.

다음 단계

Claude Code를 설치했다면, 다음 가이드로 더 깊이 들어가 보세요.

• 퀵스타트: 코드베이스 탐색부터 수정 사항 커밋까지, 실제 첫 작업을 따라가 봅니다.
• 인스트럭션과 메모리 저장하기: CLAUDE.md 파일과 자동 메모리로 Claude에게 지속적인 지침을 제공합니다.
• 일반적인 워크플로와 모범 사례: Claude Code를 최대한 활용하는 패턴을 다룹니다.
• 설정: 자신의 워크플로에 맞게 Claude Code를 커스터마이즈합니다.
• 문제 해결: 흔히 겪는 문제의 해결책을 제공합니다.
• code.claude.com: 데모, 가격, 제품 상세 정보.