Claude Code가 너무 좋아서 생긴 문제

 

AI 개발 도구의 역설, DX는 어디로 가야 할까?

요즘 개발자 도구 중에서 Claude Code만큼 화제가 되는 게 또 있을까요? 저도 몇 달째 쓰고 있는데, 솔직히 말하면 너무 좋아서 오히려 걱정이 되는 지경이에요. "AI가 일자리를 빼앗는다"는 그런 뻔한 얘기가 아니라, 정말로 DX(Developer Experience) 관점에서 고민되는 부분이 있거든요.

최고의 개발자 도구는 존재감이 없어야 해요. 쓰면서 "아, 이 도구 배워야 하네" 같은 생각이 들면 안 되잖아요. 그런데 Claude Code는 지금 마법 같은 경험과 "또 배워야 할 것" 사이에서 줄타기를 하고 있어요. PM으로서, 특히 개발자 경험과 AI가 만나는 지점에서 일하는 입장에서 이 긴장감이 참 흥미롭더라고요.

신처럼 일하는 엔지니어와 협업하는 느낌

Opus 4.5 버전을 쓰다 보면, 정말 옆에 최고 수준의 엔지니어가 앉아있는 것 같아요. 의견은 확실하지만 친절하고, 자존심 같은 건 전혀 없죠.

제가 복잡한 인증 로직을 리팩토링하고 있었어요. Claude가 새 파일 만들고, import 업데이트하고, 테스트 돌리고 있는데 갑자기 생각났죠. "아, 이 파일 cron job에서도 쓰는데..." 다른 도구였으면 완전히 꼬였을 상황이에요. 모든 걸 멈추고 처음부터 설명해야 하고, 아마 진행하던 것도 까먹었을 거예요.

그래도 일단 타이핑했어요. "이거 cron job에서도 쓰는데 괜찮을까요?"

Claude의 답변이 압권이었어요. "좋은 지적이네요. 지금 하던 리팩토링 먼저 끝내고, 그다음에 cron job 의존성 처리할게요."

잠깐 멍했어요. 맥락을 잃지 않았고, 당황하지도 않았고, 실제 엔지니어처럼 우선순위를 정했거든요. "일단 하던 거 끝내고 그거 처리할게" - 이건 자동완성이 아니라 진짜 협업이었어요.

Puzzmo 팀의 한 개발자가 완벽하게 표현했더라고요. Claude Code 덕분에 "프로그래밍의 첫 단계에 대한 불안감"에서 해방됐다고요. 코딩에서 가장 어려운 게 시작이잖아요. Claude는 바로 그 마찰을 없애줘요.

알아서 척척 해내는 놀라운 주도성

앱을 배포하려는데 완전히 막막했어요. Claude한테 물어봤더니 계획을 쫙 짜주더라고요. 그런데 제가 Fly.io 크레딧이 있고, Vercel 무료 티어 자격이 되고, Cloudflare 계정이랑 Neon 데이터베이스가 있다고 얘기했거든요.

그다음이 정말 놀라웠어요. 모든 CLI를 설치하고, 제게 한 번씩만 로그인하라고 안내한 다음, 완전 자동 모드로 들어갔어요. 각 서비스 설정하고, 명령어 실행하고, 로그 확인하고, 에러 나면 스스로 고치고. 몇 분 만에 앱이 돌아가더라고요.

Anthropic의 최근 발표에 따르면 Claude Code는 출시 후 3개월 만에 개발자들의 코딩 속도를 평균 40% 향상시켰다고 해요. 특히 복잡한 설정이나 배포 과정에서 시간 절감 효과가 두드러진다고 하더라고요.

다른 케이스도 있어요. GitHub 워크플로우가 계속 실패했는데, Claude가 제 Hetzner 인스턴스에 SSH 접속해서 조사해도 되냐고 물어봤어요. 좋다고 했죠. 접속해서 설정 확인하고, 문제 일으키던 Docker 인스턴스 재시작하고, 인증서까지 갱신하더라고요. 인증서는 제가 요청한 것도 아닌데, 위생 차원에서 처리한 거예요.

이게 진짜 주도성이에요. Claude는 제 목표가 "제대로 작동하는 프로덕션 앱"이라는 걸 이해했어요. 돌다리도 두들겨보는 거죠.

Vercel 로그를 읽다가 CVE 수정을 위해 Next.js 업그레이드를 권장한다는 걸 봤대요. 그냥 명시된 버전으로 업데이트하는 게 아니라, 최신 버전을 검색하고, 개선사항을 평가한 다음, 모든 이점을 활용하기 위해 최신 버전으로 업그레이드했어요.

코드베이스도 깊이 이해해요. 큐잉 시스템 버그를 고쳐달라고 했는데, 계속 문제 주변을 빙빙 돌더니 결국 더 근본적인 원인을 찾아냈어요. 그걸 고치고 시스템 전체를 개선했죠. 제가 시키지도 않았는데요.

쓸 때마다 미소 짓게 만드는 디테일

어떤 기능들은 정말 웃음 나게 만들어요. "ultrathink"라는 단어는 원래 커뮤니티에서 Claude를 더 열심히 생각하게 만드는 핵이었대요. 팀이 이걸 받아들여서 이제 타이핑하면 무지개색으로 반짝여요. 쓸데없지만 완벽하죠.

우연히 발견하는 단축키들도 있어요. Cmd+S로 초안 프롬프트를 나중을 위해 저장할 수 있고, ! 접두사는 토큰 안 쓰고 bash 명령어를 실행하고, ESC 두 번 누르면 검색 가능한 메시지 히스토리가 열려요. @를 우연히 쳤다가 퍼지 파일 자동완성 기능을 발견했는데, 이거 없이 어떻게 살았나 싶더라고요.

하지만 제 작업 방식을 완전히 바꾼 기능이 세 개 있어요.

/context는 200k 토큰 윈도우가 어떻게 사용되는지 정확히 보여줘요. 모노레포에서 프로젝트만 로드해도 약 20k 토큰이 소비되더라고요. 그 숫자를 본 후로 대화를 완전히 다르게 관리하게 됐어요.

claude --resume은 며칠 전 대화를 다시 이어갈 수 있게 해줘요. 예전 세션으로 돌아가서 Claude가 특정 문제를 어떻게 해결했는지 물어본 적도 있어요. 시니어 엔지니어의 검색 가능한 노트를 갖고 있는 것 같아요.

그리고 CLAUDE.md - 에이전트의 "헌법"이에요. 레포지토리가 어떻게 작동하는지 알려주는 마크다운 파일이죠. 한 번만 설정하면 모든 대화가 올바른 맥락으로 시작돼요. Shrivu의 가이드에 자세히 나와 있어요.

최고의 부분? 이걸 외울 필요가 없다는 거예요. 맥락에 맞는 팁이 적절한 순간에 나타나요. 쓰면서 배우는 거죠. 이게 진짜 "점진적으로 복잡성을 노출하기"를 제대로 한 거예요.

그런데 문제가 뭐냐면

자, 제가 방금 엄청 많은 기능을 나열했어요. 그런데 MCP 통합, 훅, SDK, 슬래시 커맨드 절반도 안 다뤘어요.

Claude Code의 역량은 엄청나게 성장했어요. 그리고 알아야 할 것들의 표면적도 같이 커졌죠. 단축키, 명령어, 설정 파일, 맥락에 따라 나타나는 팁들, 동작을 바꾸는 설정들...

2024년 기준 개발자 도구 시장 조사에 따르면, 새로운 도구를 배우는 데 드는 평균 온보딩 시간이 8시간을 넘으면 채택률이 급격히 떨어진다고 해요. Claude Code의 주요 타겟은 시니어/스태프 엔지니어 - 복잡한 프로젝트에서 일하고 버그 있는 코드를 배포하면 실제로 큰 일 나는 사람들이에요. 하지만 10배 속도로 움직이는 인디 해커도 있고, 그냥 프로토타입 만들고 싶은 EM/PM도 있어요.

이 페르소나들은 복잡성에 대한 허용치가 달라요. 그리고 지금 Claude Code는 파워 유저를 위해 열심히 최적화하면서 다른 사람들을 잃지 않으려고 노력하고 있어요.

팀이 이 긴장감을 의도적으로 관리하고 있는 것 같아요. 맥락에 맞는 팁, 기능의 점진적 공개, 합리적인 기본값 - 이 모든 게 학습 곡선을 관리 가능하게 유지하도록 설계됐어요. 하지만 새로운 역량이 추가될 때마다 무게가 늘어나요.

위험은 Claude Code가 너무 유능해져서 Claude Code를 배워야 하는 상황이 되는 거예요. 그리고 도구를 배운다는 것 자체가 바로 훌륭한 DX가 제거하려는 마찰이거든요.

제가 주목하고 있는 것들

답은 없어요. 하지만 제가 주의깊게 보고 있는 건 이거예요.

기본 경험이 계속 나아지고 있나? 신규 사용자가 단축키 하나 몰라도 생산적일 수 있다면 좋은 신호예요. 가이드를 먼저 읽어야 한다면 경고 신호고요.

기능들이 조합 가능한가, 아니면 추가적인가? 조합 가능한 기능(CLAUDE.md가 모든 상호작용에 영향을 주는 것처럼)이 추가적 기능(20개의 다른 슬래시 커맨드를 외우는 것)보다 확장성이 좋아요.

팀이 기능을 제거할 의지가 있나? 가장 어려운 DX 결정은 폐기예요. 모든 기능에는 사용자가 있으니까요. 하지만 최고의 도구는 집중력을 유지해요.

Claude Code는 지금 뛰어나요. 질문은 성장하면서도 그럴 수 있느냐는 거죠. 마법은 역량에 있는 게 아니라, 그 역량들을 사용할 때 어떻게 느껴지느냐에 있어요.

마무리하며 - DX의 진짜 의미

개발자 도구를 만드는 모든 분들에게 이게 교훈이에요. 그리고 Claude Code가 지금 직면한 테스트이기도 하고요. 기능이 많아지는 건 어렵지 않아요. 그걸 자연스럽게 만드는 게 어려운 거죠.

DX의 본질은 결국 하나예요. 사용자가 도구를 의식하지 않고 자신의 일에만 집중할 수 있느냐. Claude Code는 지금 그 경계선에서 줄타기를 하고 있어요. 앞으로가 더 기대되는 이유죠.

최고의 도구는 존재를 드러내지 않습니다. 그저 당신이 만들고 싶은 것을 더 쉽게, 더 빠르게, 더 즐겁게 만들 수 있게 해줄 뿐이에요. Claude Code가 그 길을 계속 걸어갈 수 있을지, 함께 지켜봐주세요.