이름 때문에 오해하기 쉽다
Claude Code는 단순히 코드를 짜주는 챗봇이 아니다.
터미널 환경에서 프로젝트에 직접 들어가:
- 파일 구조를 탐색하고
- 여러 파일의 코드를 동시에 수정하고
- 빌드/테스트 명령어를 직접 실행하고
- 오류 로그를 읽어 스스로 디버깅하고
- Git 커밋까지 처리하는 자율 개발 에이전트다.
한 파일보다 '프로젝트'를 본다
실제 개발에서 버그를 고칠 때 코드를 바로 타이핑하는 일은 드물다.
- 어디서 버그가 났는지 파일 전체를 탐색한다.
- 관련 모듈과 의존 관계를 파악한다.
- 코드를 고치고 로컬 서버를 돌린다.
- 오류가 안 나는지 테스트한다.
Claude Code는 이 일련의 개발자 행동 사이클을 자율적으로 수행한다.
좋은 사용법: 경계를 알려준다
"알아서 다 만들어"라고 하면 엉뚱한 라이브러리를 설치하거나 프로젝트 구조를 엎어버릴 수 있다. 명확한 가드레일을 쳐주어야 한다.
- "프론트엔드 UI 컴포넌트만 수정한다."
- "백엔드 API 규격과 DB 스키마는 절대 변경하지 마라."
- "코드 수정 전 관련 파일들을 먼저 읽고 계획을 브리핑해라."
- "작업 완료 후 반드시
npm run build와 테스트를 통과시켜라."
Claude Code vs Claude Cowork
| 구분 | Claude Code | Claude Cowork |
|---|---|---|
| 주요 환경 | 터미널, 코드 저장소, 개발자 환경 | 데스크톱 OS, 브라우저, 일반 앱, 문서 폴더 |
| 작업 대상 | 소스 코드, 설정 파일, 빌드 스크립트 | 엑셀, PDF, 이메일, 웹사이트, 업무 앱 |
| 사용 목적 | 소프트웨어 개발 및 디버깅 | 지식 노동, 자료 조사, 일반 업무 자동화 |
그래서 무엇을 다르게 할 것인가
- Claude Code에게 작업을 줄 때는 손대지 말아야 할 파일과 유지해야 할 기능을 제약 조건으로 명시한다.
- 커밋 전
git diff를 통해 의도치 않은 패키지나 파일이 변경되지 않았는지 점검한다.