Claude Code 완전 정복 — AI 터미널 코딩 도구, 한 달 써본 솔직 후기

솔직히 처음엔 반신반의했습니다.

“터미널에서 AI랑 대화하면서 코딩한다고? 그게 Cursor랑 뭐가 다르지?”

그냥 채팅창만 터미널로 옮겨놓은 거 아닌가 싶었어요. 그런데 막상 써보고 나서 생각이 꽤 많이 바뀌었습니다. 좋은 방향으로도, 나쁜 방향으로도. 이 글에서는 한 달 동안 실제 프로젝트에 Claude Code를 써보면서 느낀 점들을 있는 그대로 써보려고 합니다. 과장 없이요.

Claude Code가 뭔지 모르는 분들을 위해

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 어시스턴트입니다. 2025년 초에 등장해서 개발자 커뮤니티에서 꽤 빠르게 화제가 됐는데요, 핵심 개념은 단순합니다. IDE 플러그인이 아니라 터미널에서 직접 실행되는 CLI 도구예요.

claude 명령어 하나로 실행하면, AI가 여러분의 코드베이스를 파악하고, 파일을 읽고 수정하고, 명령을 실행하면서 개발을 도와줍니다. 단순히 “이 코드 설명해줘” 수준이 아니라, 실제로 파일을 열고 코드를 짜고 테스트까지 돌려볼 수 있어요.

Cursor가 VS Code 위에 AI를 얹은 형태라면, Claude Code는 에디터와 완전히 독립적으로 작동하는 AI 에이전트에 가깝습니다. 어떤 에디터를 쓰든 상관없다는 게 큰 차이점이에요.

설치하고 시작하는 건 생각보다 쉽습니다

npm install -g @anthropic-ai/claude-code
claude

끝입니다. Node.js만 있으면 설치 자체는 2분도 안 걸려요. 처음 실행하면 Anthropic 계정으로 로그인하라고 나오는데, claude.ai 계정이 있으면 바로 연동됩니다.

주의할 점은 요금제입니다. 무료 플랜으로도 시작할 수 있는데, 실제로 코딩 작업을 하다 보면 금방 한도에 부딪힙니다. 저는 처음에 무료로 시작했다가 이틀 만에 Max 플랜으로 업그레이드했어요. 본격적으로 쓸 생각이면 처음부터 유료 플랜을 고려하는 게 낫습니다.

프로젝트 폴더에서 claude를 실행하면 자동으로 현재 디렉토리를 파악하고, 어떤 프로젝트인지, 어떤 파일들이 있는지 분석합니다. 이때 CLAUDE.md 파일이 있으면 거기서 프로젝트 컨텍스트와 규칙을 읽어옵니다. 이 부분이 꽤 잘 설계됐다고 느꼈어요.

실제로 써보니 이런 게 좋았습니다

코드베이스 파악 능력이 진짜입니다

제가 처음으로 감탄한 건 코드베이스 이해 능력이었어요.

기존에 다른 AI 도구를 쓸 때는 항상 “이 함수는 이런 역할을 하고, 저 파일은 저런 구조고…” 하면서 제가 직접 컨텍스트를 설명해줘야 했습니다. 그게 은근히 시간도 걸리고 귀찮은 작업이었는데, Claude Code는 프로젝트 폴더를 열면 알아서 파일 구조를 파악하고 관련 파일들을 찾아서 읽어와요.

“인증 관련 버그 찾아줘”라고만 해도, 어떤 파일이 인증을 담당하는지 스스로 추적해서 파악합니다. 처음에는 그냥 그런가 보다 했는데, 대형 레포지토리에서도 이게 잘 작동하는 걸 보고 진짜 놀랐습니다.

멀티파일 수정을 한 번에

Cursor나 GitHub Copilot 같은 도구들은 기본적으로 현재 열려 있는 파일 위주로 작동합니다. 여러 파일을 동시에 수정해야 할 때는 제가 일일이 파일을 열어주거나, 컨텍스트를 추가해줘야 했어요.

Claude Code는 달랐습니다. “API 엔드포인트 추가하고 관련 타입, 테스트, 문서까지 다 업데이트해줘”라고 하면, 실제로 관련된 모든 파일을 찾아서 한 번에 수정해줍니다. 물론 확인을 거치긴 하지만, 이 플로우 자체가 훨씬 자연스럽게 느껴졌어요.

저는 Next.js 프로젝트에서 사용자 프로필 기능을 추가하는 작업을 했는데, API 라우트, 컴포넌트, 타입 정의, Prisma 스키마까지 Claude Code가 알아서 찾아서 수정해줬습니다. 직접 했으면 30분은 걸렸을 작업을 5분 만에 끝냈어요.

터미널 명령까지 직접 실행

이게 처음엔 좀 무서웠는데, 익숙해지니까 엄청나게 편했습니다.

Claude Code는 코드 수정뿐 아니라 터미널 명령도 직접 실행할 수 있어요. 패키지 설치, 테스트 실행, 빌드, git 커밋까지. “테스트 실행하고 실패하는 거 고쳐줘”라고 하면 실제로 npm test를 돌리고, 실패한 테스트를 보고, 코드를 수정하고, 다시 테스트를 돌리는 사이클을 자동으로 반복합니다.

처음에는 “AI가 내 터미널에서 뭔가를 마음대로 실행한다고?”라는 게 좀 불안했는데, 위험한 명령어는 반드시 확인을 받는 구조라 생각보다 안전하게 작동했습니다.

터미널에서 코드를 다루는 개발 환경

근데 이런 점은 좀 아쉬웠습니다

솔직하게 쓰기로 했으니까 아쉬운 점도 써야죠.

유료 플랜은 사실상 필수입니다

Claude Code를 제대로 쓰려면 유료 플랜이 거의 필수입니다. 무료 플랜으로도 시작은 할 수 있지만, 코드베이스를 분석하고 파일을 읽고 수정하는 과정에서 토큰을 꽤 소모하다 보니 실제 개발 작업에 쓰기엔 금방 한계에 부딪혀요.

저는 현재 Pro 플랜을 사용 중인데, 일반적인 사이드 프로젝트나 일상적인 개발 작업에는 충분합니다. 다만 대형 코드베이스를 통째로 분석하거나, 복잡한 리팩토링을 연속으로 돌리는 헤비한 작업을 자주 한다면 Max 플랜이 필요할 수도 있어요. Pro 플랜으로 쓰다가 작업량이 많은 날 한도에 걸리는 경험을 몇 번 하고 나면 자연스럽게 업그레이드를 고민하게 됩니다.

정리하면 이렇습니다:

  • 무료 플랜: 가볍게 체험하는 용도로만
  • Pro 플랜: 일반적인 개발 작업, 사이드 프로젝트에 적합
  • Max 플랜: 업무용이나 대규모 작업이 잦은 분께 추천

응답 속도가 들쑥날쑥합니다

간단한 질문이나 작은 파일 수정은 빠른데, 대규모 코드베이스 분석이나 복잡한 리팩토링을 할 때는 꽤 기다려야 합니다. 특히 사용자가 몰리는 시간대에는 체감이 더 크게 나요.

Cursor가 에디터에 바로 인라인으로 붙어서 빠릿빠릿하게 반응하는 것에 비하면, 에이전트 방식이라 태생적으로 더 많은 처리 시간이 필요합니다. 이건 어쩔 수 없는 구조적 차이인 것 같기도 하고요.

가끔 과잉 수정을 합니다

“이 함수 수정해줘”라고 했는데 관련 없는 파일까지 건드리는 경우가 가끔 있었어요. 보통은 수정 내역을 미리 보여주고 확인을 받기 때문에 큰 문제는 아닌데, 초반에는 무조건 승인 누르지 말고 뭘 바꾸려는지 꼭 확인하는 습관이 필요합니다.

Cursor랑 비교하면?

이 질문을 제일 많이 받을 것 같아서 따로 정리해봤습니다.

Cursor가 더 잘 맞는 경우:

  • IDE 환경에서 코딩하면서 AI를 인라인으로 빠르게 쓰고 싶을 때
  • 특정 파일이나 함수 단위의 빠른 수정이 주 목적일 때
  • 비용에 민감할 때 (Cursor가 상대적으로 비용 예측이 쉬움)

Claude Code가 더 잘 맞는 경우:

  • 특정 에디터에 구애받지 않고 작업하고 싶을 때
  • 여러 파일에 걸친 대규모 리팩토링이나 기능 추가가 잦을 때
  • 터미널 자동화, CI 파이프라인, 스크립트 작업이 많을 때
  • “이 기능 처음부터 끝까지 만들어줘” 같은 에이전트 방식이 편할 때

저는 지금 두 개를 병행해서 쓰고 있습니다. 빠른 코드 완성이나 짧은 수정은 Cursor로, 큰 단위의 기능 개발이나 복잡한 작업은 Claude Code로요. 상황에 따라 골라 쓰니까 오히려 둘 다 쓰는 게 효율적이더라고요.

개발자가 여러 모니터를 보며 작업하는 모습

어떤 사람에게 추천하나

강력 추천하는 경우:

  • 바이브 코딩에 관심 있고 AI 에이전트 방식을 경험해보고 싶은 분
  • 사이드 프로젝트를 빠르게 만들어야 하는 분
  • 유지보수 중인 코드베이스에서 대규모 변경 작업이 자주 있는 분
  • vim, neovim, Emacs 같은 에디터를 쓰는 분 (에디터 종류 무관하게 쓸 수 있음)

조금 더 생각해보면 좋은 경우:

  • 비용에 민감하거나 개인 프로젝트를 가볍게 시작하는 분
  • 코드 하나하나를 직접 통제하면서 짜고 싶은 분
  • 이미 Cursor에 완전히 익숙하고 불편함을 못 느끼는 분

마무리

한 달 써본 결론을 한 문장으로 요약하면: “기대보다 잘 작동한다, 하지만 과신하면 안 된다” 입니다.

Claude Code는 분명히 기존 AI 코딩 도구들과는 다른 무언가가 있습니다. 코드베이스를 이해하고 여러 파일을 넘나들며 작업하는 에이전트 경험은 생각보다 훨씬 인상적이었어요. 바이브 코딩의 가능성을 가장 직접적으로 느낀 도구이기도 했고요.

다만 비용과 속도, 그리고 AI가 내 코드를 자유롭게 건드린다는 부분은 처음에 적응이 필요합니다. 특히 확인 없이 무조건 승인하는 습관은 빨리 고쳐야 해요. 저도 초반에 한 번 날린 적 있습니다. git이 없었으면 큰일 날 뻔했어요.

무료로 가볍게 시작해보고, 맞다 싶으면 유료 플랜으로 넘어가는 걸 추천합니다. 생각보다 빠르게 “아, 이거 없으면 불편하겠다”는 순간이 옵니다.

다음 글에서는 Claude Code에서 실제로 효과 좋았던 프롬프트 패턴들을 정리해볼게요. 같은 작업도 어떻게 말하느냐에 따라 결과가 꽤 달라지더라고요.