Subscribe
테크 소식
Claude가 공개한 에이전틱 코딩을 위한 Claude Code 가이드
Last modified
Anthropic이 최근 공개한 Claude Code는 개발자의 코딩 워크플로우를 혁신적으로 변화시키는 명령줄 도구입니다. 연구 프로젝트로 개발된 이 도구는 유연하고 사용자 정의가 가능한 설계로 강력한 에이전틱 코딩 경험을 제공합니다. 개발자들이 각자의 작업 환경에 맞게 최적화할 수 있는 Claude Code의 효과적인 활용법을 살펴보겠습니다.
환경 설정 최적화하기
Claude Code는 자동으로 컨텍스트를 수집하여 프롬프트에 포함시킵니다. 이를 최적화하는 방법 중 가장 효과적인 것은 CLAUDE.md 파일을 활용하는 것입니다.
CLAUDE.md는 대화 시작 시 자동으로 컨텍스트에 포함되는 특별한 파일로, 다음과 같은 정보를 문서화하기에 적합합니다:
# 자주 사용하는 명령어
- npm run build: 프로젝트 빌드
- npm run typecheck: 타입 검사 실행
# 코드 스타일 가이드라인
- ES 모듈 구문 사용 (CommonJS 대신)
- 가능한 경우 import 구문 비구조화이 파일은 루트 디렉토리, 부모/자식 폴더, 홈 폴더 등 여러 위치에 배치할 수 있으며, /init 명령을 실행하면 Claude가 자동으로 생성해 줍니다.
또한 도구 허용 목록을 관리하여 파일 편집, git 명령어 등 시스템 수정 작업에 대한 권한을 설정할 수 있습니다:
•
세션 중 "항상 허용" 선택
•
/allowed-tools 명령으로 허용 도구 추가/제거
•
설정 파일 직접 편집
•
세션별 --allowedTools 플래그 사용
도구 확장으로 능력 향상하기
Claude Code는 사용자의 셸 환경에 접근할 수 있어 모든 도구를 활용할 수 있습니다. 배시 도구 사용법을 알려주거나, CLAUDE.md에 자주 사용하는 도구를 문서화하여 효율성을 높일 수 있습니다.
MCP(Model Control Protocol)를 통해 다양한 서버에 연결할 수도 있습니다:
•
프로젝트 설정으로 특정 디렉토리에서 사용
•
전역 설정으로 모든 프로젝트에서 사용
•
.mcp.json 파일로 팀과 공유
반복적인 워크플로우는 커스텀 슬래시 명령어로 자동화할 수 있습니다:
GitHub 이슈 분석 및 수정: $ARGUMENTS.
다음 단계를 따르세요:
1. `gh issue view`로 이슈 상세 확인
2. 문제 이해하기
3. 관련 파일 검색 및 수정 구현
...효과적인 워크플로우 채택하기
Anthropic 개발자들이 검증한 몇 가지 효과적인 워크플로우를 소개합니다:
탐색-계획-코드-커밋
1.
관련 파일과 코드베이스 분석 요청
2.
문제 해결 계획 수립 (think 명령어로 심화 사고 모드 활성화)
3.
솔루션 구현 및 코드 작성
4.
결과물 커밋 및 PR 생성
테스트 기반 개발
1.
예상 입출력 기반 테스트 작성
2.
테스트 실행 및 실패 확인
3.
테스트를 통과하는 코드 작성 및 반복 개선
4.
최종 코드 커밋
코드베이스 Q&A
Claude는 새로운 코드베이스 탐색에 탁월합니다. 다음과 같은 질문을 통해 프로젝트 온보딩 시간을 단축할 수 있습니다:
•
"로깅은 어떻게 구현되어 있나요?"
•
"새 API 엔드포인트를 만드는 방법은?"
•
"foo.rs 134번 줄의 async move { ... }는 무엇인가요?"
워크플로우 최적화 팁
명확한 지시 제공하기
구체적인 지시는 Claude의 성공률을 크게 향상시킵니다:
🔴 모호함: foo.py에 테스트 추가
✅ 구체적: foo.py에 로그아웃 상태의 엣지 케이스를 다루는 새 테스트 작성 (모크 사용 지양)이미지 활용하기
Claude는 스크린샷, 드래그 앤 드롭 이미지, 파일 경로를 통해 이미지를 처리할 수 있어 UI 개발과 시각적 디버깅에 유용합니다.
지속적인 방향 수정
Claude와 협업할 때 다음 도구를 활용하면 더 나은 결과를 얻을 수 있습니다:
•
코딩 전 계획 검토
•
Escape 키로 작업 중단 및 컨텍스트 유지
•
더블 Escape로 이전 프롬프트 수정
•
필요시 변경사항 되돌리기
다중 Claude 워크플로우로 효율성 극대화
한 단계 더 나아가, 여러 Claude 인스턴스를 병렬로 실행하여 복잡한 작업을 처리할 수 있습니다:
코드 작성과 검증 분리
•
한 Claude는 코드 작성, 다른 Claude는 검토
•
별도 컨텍스트 유지로 품질 향상
Git Worktrees 활용
# 새 워크트리 생성
git worktree add ../project-feature-a feature-a
# 각 워크트리에서 Claude 실행
cd ../project-feature-a && claudeClaude Code는 단순한 코딩 보조도구를 넘어 개발 생산성을 획기적으로 향상시키는 강력한 에이전틱 도구입니다. 자신만의 워크플로우를 개발하고 최적화하여 코딩 경험을 혁신해 보세요.
Subscribe to '오늘배움'
Subscribe to my site to be the first to receive notifications and emails about the latest updates, including new posts.
Join Slashpage and subscribe to '오늘배움'!
Join Slashpage and subscribe to '오늘배움'!
