01. 빠른 시작 가이드¶

Claude Code 설치하고 환경 세팅하는 법이에요.

Claude Code는 터미널에서 돌아가는 AI 에이전트예요. IDE 플러그인과 달리 파일 시스템, git, 셸 전체에 접근할 수 있어서 "대화"가 아니라 "작업"을 시킬 수 있습니다. 설치 5분이면 바로 체험할 수 있어요.

1단계: 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

Windows 필수: Git for Windows 설치 후 진행하세요.

대안: 패키지 매니저¶

Homebrew (macOS):

brew install --cask claude-code

WinGet (Windows):

winget install Anthropic.ClaudeCode

주의: 패키지 매니저로 설치하면 수동 업데이트가 필요합니다. - Homebrew: brew upgrade claude-code - WinGet: winget upgrade Anthropic.ClaudeCode

설치 확인¶

claude --version

지원 환경¶

• VS Code (권장) - 기본 IDE
• Desktop App - 독립형 애플리케이션
• Web - 브라우저에서 직접 사용
• JetBrains IDE - IntelliJ, PyCharm 등
• Cursor, Windsurf 등 다른 에디터도 지원

계정 설정¶

Claude Code를 사용하려면 다음 중 하나가 필요해요:

• Claude Pro/Max/Teams/Enterprise - claude.com 계정
• Claude Console - API 키 기반 (pay-as-you-go)
• Anthropic Bedrock - AWS 환경
• Google Vertex AI - Google Cloud 환경
• Third-party - Foundry 등 다른 제공자

2단계: 첫 체험¶

설치 확인했으면 바로 써봐요.

로그인¶

claude

처음 실행하면 로그인 안내가 나와요. /login을 입력해서 계정 연결하세요.

첫 질문¶

프로젝트 디렉토리로 이동 후 claude를 실행하고 바로 물어보세요.

이 프로젝트는 뭘 하나요?

폴더 구조 설명해줘

Claude가 파일을 직접 읽고 답해줘요. 검색창 아니고 진짜 코드 분석이에요.

첫 코드 변경¶

주 파일에 hello world 함수 추가해줘

Claude가 변경 내용을 보여주고 승인을 물어봐요. y를 누르면 파일이 실제로 바뀌어요.

Git 연동¶

변경사항 커밋해줘

diff 확인 후 커밋 메시지까지 작성해줘요.

더 다양한 예제는 공식 빠른 시작 가이드를 참고하세요.

3단계: oh-my-claudecode 플러그인 설치 (강력 추천)¶

oh-my-claudecode는 Claude Code에 멀티 에이전트 기능을 얹어주는 플러그인이에요.

왜 oh-my-claudecode인가?¶

설치 방법¶

# Claude Code 실행 후
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# 플러그인 설치
/plugin install oh-my-claudecode

deep-init 실행 (첫 사용 시 필수)¶

프로젝트 처음 시작할 때 실행하면 코드베이스 문서를 자동으로 만들어줘요.

/oh-my-claudecode:deep-init

이 명령을 실행하면

• 프로젝트 구조를 쭉 훑어서 인덱싱
• AGENTS.md 파일 생성 (디렉토리별 컨텍스트)
• 이후 검색이나 분석할 때 기반이 됨

4단계: MCP 설정¶

oh-my-claudecode 사용 시¶

/oh-my-claudecode:mcp-setup

추천 MCP 서버가 한 번에 세팅돼요.

oh-my-claudecode를 사용하지 않는 경우¶

Context7은 필수로 설치하세요!

Context7은 라이브러리 최신 문서를 실시간으로 땡겨오는 MCP 서버예요.

# CLI로 추가 (권장)
claude mcp add context7 -- npx -y @upstash/context7-mcp

# 또는 프로젝트 루트의 .mcp.json에 수동 추가
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Context7 사용 예시¶

# 라이브러리 최신 문서 조회
React 19의 새로운 훅들에 대해 Context7로 찾아봐

# 특정 버전 문서 확인
FastAPI 0.115 버전의 변경사항 알려줘

5단계: 프로젝트 설정 (CLAUDE.md)¶

프로젝트 루트에 CLAUDE.md를 만들면 Claude가 프로젝트 맥락을 바로 파악해요.

# 프로젝트 컨텍스트

## 기술 스택

- 언어: Python 3.11
- 프레임워크: FastAPI
- 데이터베이스: PostgreSQL

## 코딩 컨벤션

- PEP 8 준수
- docstring은 Google 스타일

## 주의사항

- /config 폴더의 파일은 수정하지 말 것
- 테스트는 pytest로 실행

## 자주 사용하는 명령어

- `make test` - 테스트 실행
- `make lint` - 린트 검사

유용한 명령어 요약¶

다음 단계¶

환경 설정이 끝났으면 02. AI 마인드셋에서 AI를 잘 쓰는 관점부터 잡아보세요.

참고 자료:

• oh-my-claudecode GitHub
• Claude Code 공식 문서