Claude Code 사용 시작 안내

Claude Code는 기능을 만들고, 버그를 수정하고, 개발 작업을 자동화하는 데 도움을 주는 AI 기반 코딩 도우미입니다. 전체 코드베이스를 이해하며, 여러 파일과 도구를 넘나들며 작업을 처리할 수 있습니다.

​ 시작하기

Claude Code는 터미널, IDE 확장, 데스크톱 앱, 웹 등 여러 환경에서 사용할 수 있습니다. 아래 탭에서 하나를 선택해 시작하세요. 대부분의 환경에서는 Claude 구독 또는 Anthropic Console 계정이 필요합니다. Terminal CLI, VS Code, JetBrains는 타사 제공자도 지원합니다.

• 터미널
• VS Code
• 데스크톱 앱
• 웹
• JetBrains

터미널에서 Claude Code를 직접 사용하기 위한 모든 기능을 갖춘 CLI입니다. 파일을 편집하고, 명령을 실행하고, 명령줄에서 전체 프로젝트를 관리할 수 있습니다.Claude Code를 설치하려면 터미널을 열고 자신의 시스템에 맞는 명령을 실행하세요. 터미널을 처음 사용한다면 터미널 가이드에서 터미널을 여는 방법과 명령을 붙여넣는 방법을 볼 수 있습니다.

Homebrew

brew install --cask claude-code

Homebrew에는 두 개의 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로도 설치할 수 있습니다.그다음 어떤 프로젝트에서든 Claude Code를 시작하세요. your-project를 컴퓨터의 프로젝트 디렉터리 경로로 바꾸세요:

cd your-project

claude

Claude Code는 처음 사용할 때 로그인을 요청합니다. ANTHROPIC_API_KEY 환경 변수를 설정해 두었고, Claude Code가 이를 사용할지 물었을 때 키 사용을 승인하면 로그인 프롬프트는 건너뜁니다. Quickstart로 계속하기 →

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

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

• [VS Code에 설치](vscode:extension/anthropic.claude-code)
• [Cursor에 설치](cursor:extension/anthropic.claude-code)

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

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

• macOS (Intel 및 Apple Silicon)
• Windows (x64)
• Windows ARM64
• Ubuntu 또는 Debian에서는 앱이 베타이므로 Linux 설치 안내를 따라 apt로 설치하세요.

설치한 뒤 Claude를 실행하고 로그인한 다음 Code 탭을 클릭해 코딩을 시작하세요. 이 앱에는 Claude Code가 포함되어 있으므로 CLI를 별도로 설치할 필요가 없습니다. 유료 구독이 필요합니다.데스크톱 앱 더 알아보기 →

브라우저에서 로컬 설정 없이 Claude Code를 실행하세요. 오래 걸리는 작업을 시작해 두고 완료되면 돌아와 확인하거나, 로컬에 없는 저장소에서 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다. 더 큰 작업이라면 프로젝트를 만들고 Claude가 병렬 세션을 조율하도록 맡기세요. 데스크톱 브라우저와 iOS 및 Android용 Claude 앱에서 사용할 수 있습니다. claude.ai/code에서 코딩을 시작하세요. 시작하기 →

IntelliJ IDEA, PyCharm, WebStorm 및 기타 JetBrains IDE용 플러그인으로, 대화형 diff 보기와 선택 영역 컨텍스트 공유를 지원합니다. JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 다시 시작하세요. 이 플러그인은 별도로 설치한 Claude Code CLI가 필요합니다. JetBrains 설치 단계를 참조하세요. JetBrains로 시작하기 →

​ 할 수 있는 일

Claude Code를 활용하는 몇 가지 방법은 다음과 같습니다:

미뤄 온 작업을 자동화하기

Claude Code는 하루를 잡아먹는 지루한 작업을 처리합니다. 테스트가 없는 코드에 대한 테스트 작성, 프로젝트 전반의 린트 오류 수정, 병합 충돌 해결, 종속성 업데이트, 릴리스 노트 작성 등이 여기에 포함됩니다.

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 빠른 시작은 첫 서버를 end-to-end로 연결합니다.

지침, skills, hooks로 사용자화하기

CLAUDE.md는 프로젝트 루트에 추가하는 마크다운 파일로, Claude Code가 매 세션 시작 시 읽습니다. 이를 사용해 코딩 표준, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트를 설정하세요. 저장소에 다른 코딩 에이전트를 위한 AGENTS.md가 이미 있다면, Claude Code는 CLAUDE.md 대신 그 파일을 읽을 수 있습니다. Claude는 작업하면서 자동 메모리도 구축해, 여러분이 따로 적지 않아도 세션 간 학습 내용을 저장합니다. /review-pr이나 /deploy-staging처럼 팀이 공유할 수 있는 반복 가능한 워크플로를 패키징하려면 skills를 만드세요. Hooks를 사용하면 모든 파일 편집 후 자동 포맷팅을 하거나 커밋 전에 린트를 실행하는 등, Claude Code 작업 전후로 셸 명령을 실행할 수 있습니다.

에이전트를 병렬로 실행하고 사용자 지정 에이전트 만들기

서로 다른 작업 부분을 동시에 수행하는 여러 Claude Code 에이전트를 생성하세요. 리드 에이전트가 작업을 조율하고, 하위 작업을 할당하며, 결과를 병합합니다. 여러 전체 세션을 병렬로 실행하고 한 화면에서 확인하려면 백그라운드 에이전트를 사용하세요. 완전히 사용자 지정된 워크플로가 필요하다면 Agent SDK를 통해 오케스트레이션, 도구 접근, 권한을 완전히 제어하면서 Claude Code의 도구와 기능으로 구동되는 자신만의 에이전트를 만들 수 있습니다.

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

Claude Code는 조합 가능하며 Unix 철학을 따릅니다. 로그를 파이프로 전달하거나 CI에서 실행하거나 다른 도구와 연결하세요:

1234567891011# Analyze recent log output

tail -200 app.log | claude -p "Slack me if you see any anomalies"

# Automate translations in CI

claude -p "translate new strings into French and raise a PR for review"

# Bulk operations across files

git diff main --name-only | claude -p "review these changed files for security issues"

전체 명령어와 플래그는 CLI 참조를 확인하세요.

반복 작업 예약

Claude를 일정에 따라 실행해 반복되는 작업을 자동화하세요. 예를 들어 아침 PR 검토, 밤새 진행되는 CI 실패 분석, 주간 의존성 감사, PR 병합 후 문서 동기화 등이 있습니다.

• 클라우드 예약 작업은 이전의 routines로, 클라우드에서 실행되므로 컴퓨터가 꺼져 있어도 계속 동작합니다. API 호출이나 GitHub 이벤트를 트리거로 사용할 수도 있습니다. 웹, Desktop 앱, 또는 CLI에서 /schedule을 실행해 만들 수 있습니다.
• Desktop 예약 작업은 로컬 파일과 도구에 직접 접근할 수 있는 내 컴퓨터에서 실행됩니다
• /loop는 빠른 폴링을 위해 CLI 세션 안에서 프롬프트를 반복합니다

어디서나 작업하기

세션은 하나의 화면에 묶여 있지 않습니다. 상황이 바뀌면 화면 간에 작업을 옮기세요.

• 책상에서 잠시 벗어나도 Remote Control을 사용해 휴대폰이나 어떤 브라우저에서든 계속 작업할 수 있습니다
• 휴대폰에서 Dispatch에 작업을 보내고, 생성된 Desktop 세션을 열어 보세요
• 웹이나 Claude 모바일 앱에서 장시간 실행되는 작업을 시작한 뒤, claude --teleport로 터미널에 가져오세요. Teleport를 사용하려면 claude.ai 구독이 필요합니다.
• /desktop을 실행해 현재 터미널 세션을 Desktop 앱에서 이어서 진행하면, diff를 시각적으로 검토할 수 있습니다. /desktop handoff에는 claude.ai 구독이 필요합니다. macOS 및 x64 Windows에서 사용할 수 있습니다.
• 팀 채팅에서 작업을 전달하세요: Slack에서 버그 리포트와 함께 @Claude를 언급하면 pull request를 돌려받을 수 있습니다

​ 어디서나 Claude Code 사용하기

각 surface는 같은 Claude Code 엔진에 연결되므로, 저장소의 CLAUDE.md 파일, 설정, MCP 서버를 모두에서 공통으로 사용할 수 있습니다. 위의 Terminal, VS Code, JetBrains, Desktop, Web 화면 외에도 Claude Code는 CI/CD, 채팅, 브라우저 워크플로와 통합됩니다.

​ 다음 단계

Claude Code를 설치한 뒤에는 이 가이드들을 통해 더 깊이 들어갈 수 있습니다.

• 빠른 시작: 코드베이스 살펴보기부터 수정 사항 커밋까지, 첫 실제 작업을 함께 진행합니다
• 지침과 기억 저장하기: CLAUDE.md 파일과 자동 메모리로 Claude에 지속적인 지침을 제공합니다
• 일반적인 워크플로 및 모범 사례: Claude Code를 최대한 활용하기 위한 패턴
• Claude Academy: Claude Code 101과 Claude Code in Action을 포함한 무료 자기 주도형 강좌
• 모든 작업을 위한 하니스: Claude Code 팀이 여러 하위 에이전트를 한꺼번에 조율하기 위해 동적 워크플로를 사용하는 방법
• 설정: 작업 흐름에 맞게 Claude Code를 사용자 지정하세요
• 문제 해결: 흔한 문제에 대한 해결책
• code.claude.com: 데모, 요금제, 제품 정보

출처

• 원문: https://code.claude.com/docs (2026-10-22 · code.claude.com)