Claude Code, 일 나누는 감각이 먼저다

Claude Code 이야기가 계속 보이는 걸 보면서 처음엔 또 하나의 개발자 장난감이라고 생각했습니다. 개발자 커뮤니티는 원래 새 도구가 나오면 빠르게 달아오르고, 며칠 지나면 다른 주제로 넘어가기도 하니까요. 그런데 이번 흐름은 조금 다릅니다. GeekNews에 올라온 Claude Code 워크플로 글도 그렇고, 요즘IT의 AI 에이전트 정리도 그렇고, 사람들은 단순 자동완성이 아니라 작업 단위로 움직이는 코딩 파트너를 기대하고 있습니다.

이 기대는 꽤 현실적입니다. 파일을 읽고, 수정하고, 테스트를 돌리고, 실패하면 다시 고치는 흐름은 이미 개발자의 하루와 닮아 있습니다. 문제는 여기서부터입니다. 도구가 실제 일과 닮아갈수록 사람은 더 쉽게 방심합니다. “이 정도면 알아서 하겠지”라는 생각이 들어오는 순간, AI 코딩은 편한 도구가 아니라 위험한 실행자가 됩니다.

내가 보는 핵심

Claude Code의 진짜 가치는 코드를 대신 치는 데서 끝나지 않습니다. 큰 일을 작게 쪼개고, 각 단계마다 확인 기준을 붙이는 사람에게 가장 큰 효과가 납니다.

코딩 에이전트 글은 이제 책상 사진보다, 큰 일을 작은 모듈로 쪼개는 구조 자체를 보여주는 편이 낫다.

큰 요청을 던지면 큰 사고도 같이 온다

“이 기능 좀 개선해줘”라는 요청은 사람이 보기엔 자연스럽지만 AI에게는 너무 넓습니다. AI는 넓은 요청을 받으면 넓게 움직입니다. 관련 파일을 많이 건드리고, 필요 없는 추상화를 추가하고, 기존 로직까지 손댈 수 있습니다. 결과는 그럴듯할 수 있지만 리뷰하는 사람은 피곤해집니다. 어디가 바뀌었고 왜 바뀌었는지 다시 추적해야 하니까요.

반대로 좋은 요청은 좁습니다. “로그인 실패 메시지만 바꾸고, 인증 로직은 건드리지 말고, 실패 테스트 하나만 추가해줘.” 이런 지시는 덜 멋져 보이지만 실제로 강합니다. 실패해도 되돌리기 쉽고, 성공했는지도 바로 확인할 수 있습니다. AI가 강해질수록 요청은 더 작아져야 합니다.

• 바꿀 동작을 하나로 줄인다.
• 건드리면 안 되는 파일과 로직을 먼저 말한다.
• 테스트나 확인 방법을 같이 적는다.
• 설명보다 diff와 동작을 확인한다.

개발자에게 남는 일은 더 선명해진다

Claude Code가 개발자를 없앤다는 말은 너무 빠릅니다. 내가 보기엔 개발자의 손이 하던 일 일부가 줄어드는 대신, 머리가 해야 할 일은 더 중요해집니다. 요구사항을 쪼개는 일, 위험한 변경을 알아보는 일, 배포 후 문제가 될 지점을 먼저 보는 일입니다.

특히 시니어 개발자는 여기서 더 중요해질 수 있습니다. 원래 좋은 시니어는 코드를 많이 치는 사람만이 아니라, 어디가 위험한지 먼저 보는 사람이었습니다. AI가 구현 속도를 올릴수록 이 판단의 가치는 더 커집니다.

나는 앞으로 코딩 실력의 정의가 조금 바뀔 거라고 봅니다. 손으로 빠르게 구현하는 능력도 여전히 중요하지만, 그 위에 AI에게 일을 작게 맡기고 자주 확인하는 쪽이 더 안정적으로 결과를 냅니다.

실제로 맡길 때는 순서를 바꿔야 한다

Claude Code를 처음 켜면 대부분 바로 “이거 만들어줘”라고 말하고 싶어집니다. 그런데 나는 이 순서가 좋지 않다고 봅니다. 유명한 실무형 IT 글들이 읽히는 이유도 바로 답부터 던지지 않고, 먼저 분류축을 잡기 때문입니다. 도구를 쓰기 전에 이 작업이 읽기 작업인지, 수정 작업인지, 검증 작업인지 나눠야 합니다.

1단계: 읽기	AI에게 먼저 파일 구조와 관련 흐름만 설명하게 합니다. 이때는 수정하지 못하게 막아두는 편이 낫습니다.
2단계: 계획	수정 후보 파일, 예상 위험, 테스트 방법을 먼저 내놓게 합니다. 여기서 사람의 판단이 들어갑니다.
3단계: 실행	한 번에 하나의 변경만 맡깁니다. 로그인, 결제, 권한 같은 영역은 더 잘게 나눕니다.
4단계: 검증	AI의 설명을 믿기보다 테스트, 화면 확인, diff 확인으로 끝냅니다.

이렇게 하면 속도가 느려 보일 수 있습니다. 하지만 큰 요청 하나를 던지고 나중에 수습하는 시간보다 훨씬 싸게 먹힙니다. 코딩 에이전트는 빠른 손이 아니라 빠른 반복 장치로 쓰는 쪽이 맞습니다.

내가 Claude Code에 절대 바로 맡기지 않는 일

모든 일을 AI에게 맡길 수 있다는 말은 멋있지만, 실무에서는 위험합니다. 나는 권한이 걸린 작업, 돈이 오가는 작업, 고객에게 바로 보이는 작업, 데이터 삭제가 있는 작업은 반드시 더 잘게 쪼갭니다. AI가 못해서가 아니라, 실패했을 때 사람이 설명해야 하기 때문입니다.

내 기준의 한 줄

Claude Code를 잘 쓰는 사람은 “알아서 해줘”를 잘 말하는 사람이 아니라, 어디까지 알아서 해도 되는지를 정확히 말하는 사람입니다.

그래서 이 글을 한 문장으로 다시 줄이면 이렇습니다. 코딩보다 일을 나누는 감각이 먼저다. Claude Code를 켜는 순간부터 개발자가 사라지는 게 아니라, 개발자가 대충 넘기던 작업 분해 능력이 더 크게 드러납니다. 이 감각이 없는 상태에서 AI를 쓰면 빠르게 만든 코드가 빠르게 의심스러운 코드가 됩니다.

참고한 흐름: GeekNews, 요즘IT AI 에이전트 정리