2단계 — Claude Code 시작

CLI 가 익숙하다면 5분이면 됩니다. 익숙하지 않다면 getting-started 강좌의 1~2단계 (터미널·Git) 를 먼저.

설치

# 공식 설치 스크립트
curl -fsSL https://claude.ai/install.sh | sh

# 또는 npm 글로벌
npm install -g @anthropic-ai/claude-code

claude --version 으로 확인.

첫 실행

cd my-project
claude

대화형 셸이 떠요. 자연어로 입력하면 됩니다.

> 프로젝트 구조를 보여줘
> README.md 에 사용법 섹션을 추가해 줘
> 모든 .ts 파일에서 console.log 를 logger.info 로 바꿔줘

CLAUDE.md — 프로젝트 규칙

프로젝트 루트에 CLAUDE.md 를 두면 매 세션마다 자동으로 읽혀요. 권장 형태:

# 프로젝트 규칙

## 절대 금지
- console.log 신규 사용 — 항상 logger.info 사용
- AI 크레딧 commit (Co-Authored-By, 🤖, AI-assisted, Generated with) 금지

## 패키지 매니저
- 프론트: pnpm
- 백엔드 Python: uv
- 백엔드 Java: gradle (wrapper)

## 언어
- 사용자 응답·문서·commit 메시지: 한국어

이 한 파일이 수많은 잔소리 를 대신해요.

슬래시 명령

/ 로 시작하는 명령은 내장 도구 또는 Skills.

/help       — 도움말
/init       — CLAUDE.md 초기 생성
/cost       — 이번 세션 토큰 사용량
/loop       — 자동 반복 작업 시작
/commit     — git commit 가이드

메모리 — 대화 외에 영속 저장

memory/ 폴더에 마크다운으로 기억할 것 을 적어 두면 다음 세션에서도 자동 읽힘.

> 이 프로젝트는 nextjs 16 + Tailwind 4 를 쓰니까 기억해 줘
# → memory/project_stack.md 에 자동 기록

직접 해 보기

작은 프로젝트 폴더로 들어가 claude 를 실행하고 "현재 폴더의 .md 파일 목록을 보여줘" 라고 입력해 보세요. 자동으로 LS 도구를 호출해 결과를 보여줍니다.

더 깊이

다음 단계

3단계에서는 Claude Code 와 외부 시스템을 잇는 MCP 를 만나요.