작동 방식

터미널을 열고 원하는 걸 말합니다. Claude Code가 프로젝트를 읽고, 아키텍처를 파악하고, 여러 파일에 걸쳐 수정해요.

코드 조각을 제안하는 채팅 창이 아닙니다. 실제 코드베이스 위에서 움직이는 에이전트예요. 파일을 읽고, 새로 만들고, 명령을 실행하고, 결과를 검증합니다. 터미널 안에서 다 돼요.

VS Code, Cursor, Windsurf, JetBrains 통합이 있지만, 핵심은 CLI입니다. 내 코드베이스를 전부 읽은 아주 유능한 주니어 개발자랑 대화하는 느낌이에요.

뭐가 다른가

대부분의 AI 코딩 도구는 파일 하나 단위로 작동해요. 파일을 열면 그 파일 안에서 제안합니다.

Claude Code는 프로젝트 단위로 움직여요. 파일들이 서로 어떻게 연결되는지 이해하거든요. "구독 기능 추가해줘"라고 하면, 어떤 파일을 만들지, 기존 파일 중 뭘 수정할지, 인증 시스템이나 DB랑 어떻게 연결할지를 알아요.

변경이 5개 이상 파일에 걸칠 때 차이가 확 납니다. 파일 단위 도구는 모든 편집을 내가 하나씩 관리해야 해요. 프로젝트 단위 에이전트는 그걸 알아서 해요.

제가 쓰는 방식

Claude Code를 주 개발 도구로 써서 한 달에 네이티브 앱 4개를 만들었어요. 보조가 아니라 — 코드가 작성되는 메인 수단으로요.

워크플로우:

1. 뭐가 필요한지 말로 정의
2. Claude Code가 코드베이스 전체에 걸쳐 구현
3. 리뷰 — 내 의도랑 맞나?
4. 피드백
5. 맞을 때까지 반복

여기서 배운 게 하나 있어요. Claude Code는 프로젝트가 좋아야 결과도 좋습니다. 패턴이 명확하고 타입이 있고 규칙이 일관된 코드베이스에서는 신뢰할 수 있는 코드가 나와요. 엉망인 프로젝트에서는 엉망인 코드가 나옵니다.

그래서 보일러플레이트랑 같이 써요. 보일러플레이트가 구조를, 에이전트가 속도를 담당합니다.

못 하는 것

솔직히 말하면요.

Claude Code는 뭘 만들지 결정 못 해요. 제품 아이디어가 좋은지 나쁜지 판단 못 합니다. 구현 전에 해야 하는 생각을 대신 안 해줘요.

진짜 새로운 문제에서도 어려워해요 — 학습 데이터에 사례가 없는 것들. 모호한 라이브러리의 엣지 케이스. Apple 문서를 꼼꼼히 읽어야 하는 플랫폼 버그.

제가 따르는 원칙: 구현은 에이전트에게, 아키텍처와 제품 결정은 사람이. AI가 실행을 싸게 만들었지, 판단을 싸게 만든 건 아니거든요.