💡 한줄 요약: Anthropic이 직접 공개한 Claude Code 사용법!
CLAUDE.md설정부터 커스텀 슬래시 커맨드까지, 에이전트와 제대로 협업하는 노하우를 공개합니다.
배경
최근 Anthropic이 터미널 기반 에이전트 코딩 도구인 Claude Code를 리서치 프리뷰로 공개했습니다. 많은 개발자들이 사용하고 있지만, "그냥 터미널에서 채팅하는 거 아냐?"라고 생각하기 쉽죠.
하지만 Anthropic 내부 엔지니어들이 사용하는 방식은 훨씬 고도화되어 있습니다. 이 글은 Anthropic이 직접 공개한 "Claude Code를 200% 활용하는 베스트 프랙티스"입니다. 단순히 도구를 쓰는 것을 넘어, 에이전트와 '협업'하는 워크플로우를 정립하고 싶은 분들에게 필독서가 될 것 같네요.
특히 CLAUDE.md를 통한 컨텍스트 최적화와 커스텀 슬래시 커맨드는 당장 내 프로젝트에 적용해볼 수 있는 꿀팁들입니다.
📌 핵심 정리
CLAUDE.md활용: 프로젝트 루트에 이 파일을 두면 Claude가 시작할 때 자동으로 읽습니다. 빌드/테스트 명령어, 코딩 스타일, 프로젝트 구조 등을 적어두세요.- 슬래시 커맨드 커스텀:
.claude/commands/폴더에 자주 쓰는 프롬프트를 마크다운으로 저장하면/my-command형태로 호출 가능합니다. - MCP (Model Context Protocol):
.mcp.json파일을 통해 팀원들과 유용한 MCP 서버(예: Puppeteer, Github) 설정을 공유할 수 있습니다. - Think 모드 활용: 복잡한 설계나 리팩토링 시에는
/think명령어로 Claude에게 "생각할 시간"을 주세요. - 탐색-계획-코딩-커밋: 무작정 코드를 짜라고 하지 말고, "파일 읽어봐" -> "계획 세워줘" -> "코드 짜줘" 순서로 접근하세요.
- 서브 에이전트: 복잡한 문제는 메인 에이전트의 컨텍스트를 아끼기 위해 서브 에이전트에게 위임하는 것이 좋습니다.
MAX5의 생각 🎯
👨💻 바이브 코딩 레시피
Claude Code를 팀 단위로 도입한다면 CLAUDE.md 파일 관리가 핵심입니다. 아래 내용을 CLAUDE.md에 추가해보세요.
# Project Context for Claude
## Commands
- Build: `npm run build`
- Test: `npm test` (Prefer running single test files for speed)
- Lint: `npm run lint`
## Tech Stack & Style
- Framework: Next.js 14 (App Router)
- Styling: Tailwind CSS (No arbitrary values, use design tokens)
- State: Zustand
- Formatting: Prettier default
## Development Rules
- 작은 단위로 커밋할 것.
- 모든 함수에는 JSDoc 스타일의 주석을 달 것.
- 새로운 라이브러리 추가 시 반드시 사전에 물어볼 것.
이렇게 설정해두면 매번 "Next.js 앱 라우터 써줘", "테일윈드 써줘"라고 말하지 않아도 알아서 스타일을 맞춰줍니다. 바이브 코딩의 핵심은 "반복되는 컨텍스트 주입을 자동화하는 것"이니까요! 😉
💸 사이드 프로젝트 아이디어
"Claude Code 설정 매니저"는 어떨까요?
팀마다, 프로젝트마다 다른 CLAUDE.md와 .claude/config.json 설정을 쉽게 생성하고 관리해주는 CLI 도구입니다.
- 유명한 오픈소스 프로젝트들의
CLAUDE.md템플릿 제공 - 프로젝트 유형(React, Python, Go 등)에 따른 자동 스캐폴딩
- 팀원 간 설정 동기화 기능