claudekit / guides / getting-started
[ Guide · Beginner · 12분 ]

Claude Code 처음 시작하기

published · updated

Claude Code를 처음 설치하는 사용자를 위한 입문 가이드. 설치 방법, 구독 옵션, 처음 익혀야 할 명령어와 사용 가능한 환경을 한 번에 정리합니다.

Claude Code란?

Anthropic의 AI 기반 코딩 도구입니다. 터미널에서 자연어로 다음을 지시할 수 있습니다.

  • 멀티 파일 코드 작성·수정
  • 셸 명령 실행과 결과 분석
  • 테스트 작성·실행
  • Git 커밋과 PR 작성
  • 디버깅·리팩터링·코드 리뷰

본 가이드는 터미널 CLI 기준이지만, Claude Code는 웹, 데스크톱 앱, VS Code·JetBrains 확장, Slack, GitHub Actions·GitLab CI/CD에서도 동일하게 사용할 수 있습니다.

시작하기 전에

다음이 필요합니다.

  • 열려 있는 터미널 또는 명령 프롬프트
  • 작업할 코드 프로젝트
  • 다음 중 하나의 액세스:
    • Claude 구독 (Pro, Max, Teams 또는 Enterprise) — 권장
    • Claude Console 계정 (선불 크레딧 기반 API 액세스)
    • 지원되는 클라우드 제공자 (Amazon Bedrock, Google Vertex AI, Microsoft Foundry)

단계 1 — 설치

공식 문서가 권장하는 방법은 Native Install입니다. 자동 업데이트가 적용됩니다.

공식 빠른 시작 문서: code.claude.com/docs/ko/quickstart — 설치 방법별 최신 명령과 OS별 차이는 항상 공식 문서를 우선 확인하세요.

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

Homebrew (macOS / Linux)

brew install --cask claude-code

claude-code는 안정 채널, claude-code@latest는 최신 채널입니다. Homebrew 설치는 자동 업데이트되지 않으므로 brew upgrade claude-code(또는 claude-code@latest)를 주기적으로 실행해야 합니다.

WinGet (Windows)

winget install Anthropic.ClaudeCode

WinGet도 자동 업데이트되지 않으므로 winget upgrade Anthropic.ClaudeCode로 주기적 업데이트 필요. Linux는 apt/dnf/apk 패키지 매니저로도 설치 가능합니다.

Native Install이 자동 업데이트되어 가장 간편합니다. Homebrew·WinGet은 명시적 업데이트가 필요하니 환경에 맞게 선택하세요.

단계 2 — 로그인

claude로 대화형 세션을 시작하면 처음에는 자동으로 로그인 프롬프트가 표시됩니다.

claude

세션 도중에는 /login 명령으로 다시 로그인할 수 있습니다.

/login

지원되는 계정 유형:

  • Claude Pro / Max / Teams / Enterprise — 권장
  • Claude Console — 선불 크레딧 기반 API 액세스. 첫 로그인 시 비용 추적용 “Claude Code” 워크스페이스가 자동 생성됨
  • Amazon Bedrock / Google Vertex AI / Microsoft Foundry — 엔터프라이즈 클라우드 제공자

자격 증명은 한 번 로그인하면 시스템에 저장되어 다시 로그인할 필요가 없습니다.

단계 3 — 첫 세션 시작

프로젝트 디렉토리로 이동해 claude를 실행합니다.

cd /path/to/your/project
claude

세션 정보·최근 대화·최신 업데이트가 포함된 환영 화면이 표시됩니다. /help로 사용 가능한 명령을, /resume으로 이전 대화 이어가기를 확인할 수 있습니다.

단계 4 — 첫 질문

코드베이스를 이해하는 것부터 시작합니다.

이 프로젝트는 무엇을 하나요?
이 프로젝트는 어떤 기술을 사용하나요?
주요 진입점은 어디인가요?

Claude는 필요한 파일을 자동으로 읽으므로 컨텍스트를 수동으로 추가할 필요가 없습니다.

단계 5 — 첫 코드 변경

주 파일에 hello world 함수 추가

Claude Code는 다음을 수행합니다.

  1. 적절한 파일 찾기
  2. 제안된 변경 사항 표시
  3. 권한 요청
  4. 편집 수행

파일을 수정하기 전에는 항상 권한을 요청하며, 개별 승인 또는 세션 단위 “모두 수락” 모드를 선택할 수 있습니다.

단계 6 — Git 사용

어떤 파일을 변경했나요?
설명적인 메시지로 변경 사항 커밋
feature/quickstart라는 새 브랜치 생성
병합 충돌을 해결하는 데 도움을 주세요

단계 7 — 버그 수정과 기능 추가

자연어로 원하는 것을 설명하면, Claude가 관련 코드를 찾고 컨텍스트를 이해해 솔루션을 구현하고, 사용 가능한 경우 테스트를 실행합니다.

사용자 등록 양식에 입력 유효성 검사 추가
사용자가 빈 양식을 제출할 수 있는 버그가 있습니다 — 수정해주세요

단계 8 — 다른 워크플로

인증 모듈을 콜백 대신 async/await를 사용하도록 리팩터링
계산기 함수에 대한 단위 테스트 작성
설치 지침으로 README 업데이트
내 변경 사항을 검토하고 개선 사항을 제안해주세요

필수 명령

명령기능
claude대화형 모드 시작
claude "task"일회성 작업 실행
claude -p "query"일회성 쿼리 실행 후 종료
claude -c현재 디렉토리에서 가장 최근 대화 계속
claude -r이전 대화 재개
claude commitGit 커밋 생성
/help사용 가능한 명령 표시
/clear대화 기록 지우기
/resume이전 대화 이어가기
exit 또는 Ctrl+CClaude Code 종료

전체 목록은 CLI 참조를 참고하세요.

초보자 팁

  • 구체적으로 요청하기 — “버그 수정”보다 “잘못된 자격 증명 입력 후 빈 화면이 나오는 로그인 버그 수정”
  • 단계별 지침 — 복잡한 작업은 1·2·3 단계로 나눠 전달
  • Claude가 먼저 탐색하게 — 변경 전에 “데이터베이스 스키마 분석” 같은 이해 단계를 먼저 요청
  • 단축키 활용 — ?로 키보드 단축키, Tab으로 명령 완성, ↑로 명령 기록, /로 모든 명령 보기

CLAUDE.md로 컨텍스트 제공

프로젝트 루트의 CLAUDE.md 파일은 모든 세션에서 자동으로 로드됩니다. 권장 내용:

  • 프로젝트 개요와 기술 스택
  • 디렉토리 구조 요약
  • 주요 명령어 (build, dev, test 등)
  • 코드 컨벤션과 금지 사항

자세한 작성법은 CLAUDE.md 잘 쓰는 법 가이드를 참고하세요.

Plan mode

복잡한 작업은 Plan mode에서 시작하면 Claude가 코드 변경 전에 계획을 먼저 제시합니다. Shift+Tab으로 진입·해제할 수 있고, 검토 후 승인하면 실행이 시작됩니다. 자세한 사용법은 Plan mode 제대로 쓰기 가이드를 참고하세요.

다음 단계

§ 16

자주 묻는 질문

자주 묻는 질문
§ 16.1
Claude Code는 무엇인가요?
Anthropic의 AI 기반 코딩 도구로, 터미널·웹·데스크톱 앱·VS Code·JetBrains·Slack·CI/CD 등 여러 인터페이스에서 사용할 수 있습니다. 자연어로 코드를 읽고 수정·실행·리뷰까지 자율적으로 처리합니다.
§ 16.2
사용하려면 무엇이 필요한가요?
터미널 또는 명령 프롬프트, 작업할 코드 프로젝트, 그리고 Claude 구독(Pro·Max·Teams·Enterprise) 또는 Claude Console 계정 또는 지원되는 클라우드 제공자(Bedrock·Vertex AI·Foundry) 액세스가 필요합니다.
§ 16.3
어떻게 설치하나요?
공식 문서가 권장하는 Native Install이 가장 간단합니다. macOS/Linux/WSL은 `curl -fsSL https://claude.ai/install.sh | bash`, Windows PowerShell은 `irm https://claude.ai/install.ps1 | iex`로 설치하면 자동 업데이트도 함께 활성화됩니다. Homebrew(`brew install --cask claude-code`)나 WinGet(`winget install Anthropic.ClaudeCode`)도 가능하지만 자동 업데이트가 안 되어 주기적 수동 업데이트가 필요합니다.
§ 16.4
처음 어떤 명령어부터 익히면 되나요?
`claude`(대화형 모드), `claude -p "query"`(일회성 쿼리), `claude -c`(가장 최근 대화 계속), `claude -r`(이전 대화 재개), `/help`, `/clear`를 먼저 알아두면 됩니다. 자세한 목록은 `?`로 키보드 단축키를 보거나 `/help`를 입력합니다.
§ 16.5
터미널 외 다른 환경에서도 쓸 수 있나요?
네. 웹(claude.ai/code), 데스크톱 앱, VS Code, JetBrains IDE, Slack, GitHub Actions, GitLab CI/CD에서 모두 사용할 수 있습니다.