AI 코딩 도구 시장이 빠르게 재편되고 있습니다. Cursor, Copilot, Windsurf가 자리를 굳히는 사이, Anthropic이 직접 만든 Claude Code가 실무 개발자들 사이에서 조용히 퍼지고 있습니다. GitHub Copilot처럼 IDE 안에 가두지 않고, 터미널에서 파일을 직접 읽고·쓰고·실행합니다.
이 가이드는 설치부터 CLAUDE.md 프로젝트 메모리 설정, 멀티에이전트 패턴, 그리고 서버에서 24시간 돌리는 법까지 한국어로 정리했습니다.
Claude Code란?
Claude Code는 Anthropic이 2025년 출시한 터미널 기반 AI 코딩 에이전트입니다. IDE 플러그인이 아닙니다 — npm으로 설치하고, 터미널에서 실행하면 현재 디렉터리 전체를 문맥으로 읽어서 코드를 직접 수정합니다.
- 파일 직접 편집 — 제안이 아닌 실제 파일 수정
- 명령어 실행 —
npm test,git commit등을 직접 수행 - 멀티에이전트 — 서브에이전트를 병렬 실행해 복잡한 작업 분산
- CLAUDE.md — 프로젝트별 지시사항 영구 기억
설치 방법
Node.js 18 이상이 필요합니다.
# 글로벌 설치
npm install -g @anthropic-ai/claude-code
# 버전 확인
claude --version설치 후 처음 실행하면 Anthropic 계정 로그인 및 API 키 설정이 진행됩니다.
# 첫 실행 — 브라우저 인증 플로우가 열립니다
claudeAPI 키를 직접 쓰고 싶으면:
export ANTHROPIC_API_KEY="sk-ant-..."
claude기본 사용법
프로젝트 루트에서 claude를 입력하면 대화 모드로 진입합니다. 가장 자주 쓰는 패턴:
# 대화 모드 진입
cd my-project
claude
# 한 줄 명령 (대화 없이 바로 실행)
claude -p "users 테이블에 created_at 컬럼을 추가하는 마이그레이션 파일 만들어줘"
# 특정 파일 컨텍스트로 시작
claude -p "이 함수의 엣지케이스를 테스트 코드로 작성해줘" src/auth.ts주요 슬래시 명령어:
/help— 사용 가능한 명령어 목록/clear— 컨텍스트 초기화/cost— 현재 세션 토큰 비용 확인/compact— 컨텍스트 압축 (긴 세션에서 사용)/init— CLAUDE.md 자동 생성
CLAUDE.md — 프로젝트 메모리
Claude Code의 핵심 기능 중 하나입니다. 프로젝트 루트에 CLAUDE.md 파일을 만들면, Claude Code가 세션마다 자동으로 읽어서 컨텍스트를 유지합니다.
# 프로젝트 규칙
## 기술 스택
- Next.js 15 (App Router), TypeScript strict mode
- Drizzle ORM + PostgreSQL
- pnpm 사용 (npm, yarn 금지)
## 코딩 컨벤션
- 컴포넌트는 named export만 사용
- API 라우트 응답은 반드시 { data, error } 구조
- 테스트는 vitest 사용, Jest 금지
## 자주 쓰는 명령어
- 개발 서버: `pnpm dev`
- 빌드: `pnpm build`
- DB 마이그레이션: `pnpm db:push`
## 주의사항
- .env 파일 절대 수정 금지
- production 브랜치 직접 커밋 금지이 파일 하나로 “항상 pnpm 써”, “named export만” 같은 지시를 매번 반복할 필요가 없어집니다.
멀티에이전트 패턴
Claude Code의 진짜 강점은 서브에이전트 병렬 실행입니다. 복잡한 작업을 여러 에이전트로 나눠서 동시에 처리합니다.
# 오케스트레이터에게 복잡한 작업 지시
claude -p "이 Next.js 프로젝트를 분석해서:
1. 성능 병목 3개 찾기
2. 각 병목마다 수정 PR 준비
3. 수정 후 테스트 통과 확인
— 병렬로 진행해줘"내부적으로 Claude Code는 분석 에이전트 → 수정 에이전트 → 검증 에이전트를 순서대로 또는 병렬로 실행합니다. 대규모 리팩터링, 다국어 번역, 여러 파일 동시 수정에 효과적입니다.
서버에서 24시간 돌리기
자동화 파이프라인(GitHub PR 자동 리뷰, 야간 마이그레이션 검사, 크론 기반 코드 품질 체크)을 돌리려면 노트북이 꺼져도 살아있는 서버가 필요합니다.
가장 빠른 방법은 DigitalOcean Droplet입니다. $6짜리 가장 작은 플랜도 Claude Code CLI + 간단한 자동화 스크립트를 충분히 돌립니다. 지금 신규 가입하면 60일 $200 크레딧을 제공해서 사실상 두 달은 무료 테스트가 가능합니다.
아시아·한국 타깃 서비스라면 HTStack 홍콩 VPS가 레이턴시 면에서 유리합니다.
# 서버에서 Claude Code 설치 (Ubuntu 22.04 기준)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code
# API 키 환경변수 설정
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrc
source ~/.bashrc
# 헤드리스(non-interactive) 모드로 실행
claude --dangerously-skip-permissions -p "daily code review 실행" 2>&1 | tee review.logcron과 조합하면 매일 자정에 자동으로 돌릴 수 있습니다.
# crontab -e
0 0 * * * /usr/bin/claude --dangerously-skip-permissions -p "PR 체크리스트 검토" >> /var/log/claude-review.log 2>&1실전 팁
- 컨텍스트 관리: 세션이 길어지면
/compact로 압축. 토큰 낭비를 줄입니다. - 비용 모니터링:
/cost로 실시간 확인. 대규모 리팩터링 전에 먼저 체크. - 권한 범위 지정: 민감한 디렉터리는
--ignore플래그로 제외. - Git과 함께: 작업 전
git stash, 작업 후 diff 확인을 습관화. Claude Code가 생각지 못한 파일을 건드릴 수 있습니다. - 헤드리스 모드: CI/CD에서 쓸 때는
--dangerously-skip-permissions플래그. 이름이 무서워 보이지만, 인터랙티브 확인 없이 자동 실행하겠다는 의미입니다.
정리
Claude Code는 IDE 안에 갇히지 않습니다. 터미널에서 파일을 직접 다루고, 멀티에이전트로 병렬 처리하고, 서버에 올려 자동화 파이프라인을 구성할 수 있습니다. CLAUDE.md 하나로 프로젝트 컨텍스트를 영구 기억시키고, 반복적인 지시를 줄이는 게 핵심입니다.
서버 배포가 고민이라면 DigitalOcean ($200 크레딧 신규 가입)부터 시작하는 게 가장 빠릅니다.
※ 본 글의 일부 링크는 제휴(affiliate) 링크입니다. 클릭·가입 시 추가 비용 없이 블로그 운영에 도움이 됩니다.
