MoreLean

[개발 가이드] Claude Code 제대로 쓰는 법: Anthropic이 공개한 8가지 베스트 프랙티스

최근 공개된 Claude Code는 단순한 코딩 어시스턴트를 넘어, 직접 파일을 수정하고 터미널 명령어를 실행하는 '에이전트'형 도구입니다. 하지만 강력한 만큼 제대로 쓰는 법을 아는 것이 중요합니다. Anthropic 공식 문서( https://code.claude.com/docs/en/best-practices )를 바탕으로, Claude Code의 성능을 극대화하는 꿀팁을 정리했습니다. 1. 핵심 철학: "검증 가능하게 지시하라"Claude Code를 사용할 때 가장 중요한 한 가지를 꼽으라면 바로 **'검증 수단 제공'**입니다. Claude가 코드를 짠 후 잘 돌아가는지 스스로 확인할 수 있게 해주세요.Bad: "이메일 유효성 검사 함수 만들어줘."Good: "이메일 유효성 검사 함수를 만들고..

들어가며Claude Code에서 GitHub와 연동하려고 할 때, 선택지가 여러 개다:GitHub MCP 서버Skills (SKILL.md)gh CLI + CLAUDE.md처음엔 당연히 MCP가 "올바른" 방법이라 생각했다. 공식적이고, 구조화되어 있고, 뭔가 있어 보이니까. 하지만 실제로 팀 프로젝트에 적용하려다 보니 예상치 못한 문제를 만났다.문제의 시작: 팀 프로젝트에서 토큰 공유프로젝트 레벨의 MCP 설정(.mcp.json)을 git으로 공유하려 했다. 그런데 GitHub MCP는 인증 토큰이 필요하다.{ "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { ..

키보드 단축키부터 외우세요. Cmd+K는 퀵 액션, Cmd+Shift+P는 명령 팔레트, Cmd+/는 주석 토글, Cmd+D는 같은 단어 선택... 이런 거 손에 익으면 마우스 안 쓰고도 코딩할 수 있어요. 처음엔 느려도 1주일만 연습하면 2배는 빨라져요.TL;DR키보드 단축키: Escape(중단), Double-Escape(되감기), Tab(자동완성)프롬프트: 구체적 + 컨텍스트 = 최고의 결과물자동 커밋: Stop Hook으로 세션 종료 시 자동 커밋PR 템플릿: .github/pull_request_template.md로 표준화/clear 자주: 새 작업마다 컨텍스트 리셋커스텀 명령어: 반복 작업을 한 줄로1. 키보드 단축키 마스터하기Claude Code 핵심 단축키"Press Escape to i..

보안은 절대 타협하면 안 돼요. Rules 시스템 적극 활용하세요.CLAUDE.md에 "API 키 절대 하드코딩 금지, 환경 변수 무조건 사용" 이렇게 박아두면 Claude Code가 지켜줘요.Security Reviewer Agent도 돌려보세요. SQL 인젝션, XSS, CSRF 같은 취약점 자동으로 찾아내요. 배포 전에 꼭 한 번 체크하는 습관 들이세요.TL;DR기본 원칙: Claude를 "똑똑하지만 신뢰할 수 없는 인턴"으로 대하기Permission 시스템: allow/deny/ask 규칙으로 세밀하게 제어Sandbox: /sandbox로 파일시스템 + 네트워크 격리 (84% 권한 요청 감소)민감 파일 차단: .env, ~/.ssh/, ~/.aws/ 접근 denyCLAUDE.md: 보안 규칙 명시..

TDD 워크플로우 제대로 돌리는 법도 알려드릴게요. RED-GREEN-REFACTOR 사이클이에요.RED는 실패하는 테스트 먼저 쓰는 거예요. 아직 기능 없으니까 당연히 실패하죠. GREEN은 테스트 통과할 만큼만 코드 짜는 거예요. REFACTOR는 그 코드를 깔끔하게 리팩토링하는 거고요.이 순서 지키면 버그가 확 줄어들어요. 해커톤 때 이렇게 했더니 테스트 커버리지 80% 넘겼거든요.TL;DRTDD = Anthropic 공식 권장 워크플로우 ("Anthropic-favorite workflow")RED → GREEN → REFACTOR 사이클 반복Claude에게 명시적으로 TDD임을 알려야 함 (mock 방지)테스트 먼저 작성 → 실패 확인 → 최소 구현 → 리팩토링/tdd 커스텀 명령어로 자동화 가..

Extended Thinking이라는 기능도 있어요.복잡한 문제 주면 Claude Code가 스스로 여러 각도로 생각해봐요. "이렇게 하면 어떻게 되지? 저렇게 하면?" 혼자 시뮬레이션 돌리는 거죠.시간은 오래 걸리지만 퀄리티가 확실히 달라요. 중요한 기능 만들 때 한 번씩 써보세요.TL;DRExtended Thinking = Claude가 답변 전에 깊이 생각하는 공식 기능Claude Code에서 기본 활성화 (최대 31,999 토큰)Ctrl+O로 thinking 과정 볼 수 있음 (verbose mode)"think", "think hard", "ultrathink" 키워드로 thinking budget 조절복잡한 아키텍처, 어려운 버그, 수학/분석에 효과적시간/비용 더 들지만 퀄리티 확실히 향상Ex..

컨테이너 격리도 중요해요. 특히 프로젝트 여러 개 동시에 진행할 때요.Docker나 devcontainer 쓰면 환경이 완전히 분리돼요. A 프로젝트 Node 버전이랑 B 프로젝트 Node 버전 충돌 걱정 없어지죠.Claude Code도 devcontainer 지원해요. .devcontainer 폴더 만들고 설정 파일 넣으면 자동으로 컨테이너 안에서 작업해요. 환경 꼬일 일이 없어요.TL;DR컨테이너 격리 (devcontainer)프로젝트별 완전한 환경 분리Node/Python 버전 충돌 없음YOLO 모드를 안전하게 사용 가능Anthropic 공식 레퍼런스 제공병렬 개발 (git worktree)여러 Claude 인스턴스 동시 실행같은 레포에서 독립적 작업디스크 공간 효율적 (전체 복사 X)공식 베스트 ..

고급 기능 하나 알려드릴게요. ultrathink라는 키워드예요.프롬프트에 ultrathink 넣으면 Claude Code가 더 깊게 생각해요. 복잡한 아키텍처 설계하거나 어려운 버그 잡을 때 쓰면 성공률이 확 올라가요.단, 시간이 좀 더 걸려요. 급할 땐 빼고, 정말 중요한 결정할 때만 ultrathink 쓰세요.TL;DRthink — 단계별 thinking 강도ultrathink = 최대 32,000 토큰의 thinking budget 할당복잡한 아키텍처, 까다로운 버그에 효과적Claude Code 전용 기능 (일반 Chat/API에서는 안 됨)시간/비용 더 드니까 중요한 결정에만 사용Extended Thinking이란?"We recommend using the word 'think' to trig..

Claude Code의 커스텀 슬래시 명령어를 알면 혼자서도 팀 개발하는 느낌이 나요. 정말이에요./tdd 치면 테스트 주도 개발 모드로 들어가요. RED-GREEN-IMPROVE 사이클 돌면서 테스트 먼저 짜고 코드 구현하거든요. /plan은 작업 계획 세우고, /e2e는 E2E 테스트 만들어주고, /code-review는 코드 리뷰 돌려줘요.자주 쓰는 워크플로우를 명령어 하나로 실행할 수 있어요.TL;DR커스텀 명령어 = 저장된 프롬프트를 한 번에 실행위치: .claude/commands/ (프로젝트) 또는 ~/.claude/commands/ (전역)파일명 = 명령어 이름 (tdd.md → /tdd)$ARGUMENTS로 인자 전달 가능frontmatter로 도구 제한, 모델 지정 가능커스텀 명령어란?..

Claude Code의 Skills와 **Agents(서브에이전트)**는 꼭 알아야 하는 기능이에요.Skills는 Claude에게 추가 능력을 부여하는 거예요. Agents는 특화된 전문가를 호출하는 거고요. Planner Agent는 프로젝트 전체 구조를 설계하고, Architect는 기술 스택을 추천하고, Code Reviewer는 코드 리뷰를, Security Reviewer는 보안 취약점을 찾아줘요.마치 시니어 개발자 팀을 고용한 것처럼 일할 수 있어요.TL;DRSkills: Claude에게 새로운 능력을 부여하는 지식 패키지Agents: 특화된 작업을 수행하는 전문가 서브에이전트빌트인 Agents: Explore (탐색), Plan (계획)커스텀 Agents 생성 가능: /agents 명령으로 ..