# Claude가 공개한 에이전틱 코딩을 위한 Claude Code 가이드

![Image](https://upload.cafenono.com/image/slashpagePost/20250420/160719_bCpBA3TmDG7ExpyWsY?q=80&s=1280x180&t=outside&f=webp)

Anthropic이 최근 공개한 Claude Code는 개발자의 코딩 워크플로우를 혁신적으로 변화시키는 명령줄 도구입니다. 연구 프로젝트로 개발된 이 도구는 유연하고 사용자 정의가 가능한 설계로 강력한 에이전틱 코딩 경험을 제공합니다. 개발자들이 각자의 작업 환경에 맞게 최적화할 수 있는 Claude Code의 효과적인 활용법을 살펴보겠습니다.

## 환경 설정 최적화하기

Claude Code는 자동으로 컨텍스트를 수집하여 프롬프트에 포함시킵니다. 이를 최적화하는 방법 중 가장 효과적인 것은 CLAUDE.md 파일을 활용하는 것입니다.

CLAUDE.md는 대화 시작 시 자동으로 컨텍스트에 포함되는 특별한 파일로, 다음과 같은 정보를 문서화하기에 적합합니다:

```javascript
# 자주 사용하는 명령어
- 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` 파일로 팀과 공유

반복적인 워크플로우는 커스텀 슬래시 명령어로 자동화할 수 있습니다:

```javascript
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의 성공률을 크게 향상시킵니다:

```javascript
🔴 모호함: foo.py에 테스트 추가
✅ 구체적: foo.py에 로그아웃 상태의 엣지 케이스를 다루는 새 테스트 작성 (모크 사용 지양)
```

### 이미지 활용하기

Claude는 스크린샷, 드래그 앤 드롭 이미지, 파일 경로를 통해 이미지를 처리할 수 있어 UI 개발과 시각적 디버깅에 유용합니다.

### 지속적인 방향 수정

Claude와 협업할 때 다음 도구를 활용하면 더 나은 결과를 얻을 수 있습니다:

- 코딩 전 계획 검토

- Escape 키로 작업 중단 및 컨텍스트 유지

- 더블 Escape로 이전 프롬프트 수정

- 필요시 변경사항 되돌리기

## 다중 Claude 워크플로우로 효율성 극대화

한 단계 더 나아가, 여러 Claude 인스턴스를 병렬로 실행하여 복잡한 작업을 처리할 수 있습니다:

### 코드 작성과 검증 분리

- 한 Claude는 코드 작성, 다른 Claude는 검토

- 별도 컨텍스트 유지로 품질 향상

### Git Worktrees 활용

```javascript
# 새 워크트리 생성
git worktree add ../project-feature-a feature-a

# 각 워크트리에서 Claude 실행
cd ../project-feature-a && claude
```

Claude Code는 단순한 코딩 보조도구를 넘어 개발 생산성을 획기적으로 향상시키는 강력한 에이전틱 도구입니다. 자신만의 워크플로우를 개발하고 최적화하여 코딩 경험을 혁신해 보세요.

---

[https://www.anthropic.com/engineering/claude-code-best-practices](https://www.anthropic.com/engineering/claude-code-best-practices) 

[https://www.anthropic.com/engineering/claude-code-best-practices](https://www.anthropic.com/engineering/claude-code-best-practices)

For the site tree, see the [root Markdown](https://blog.learntoday.kr/.md).