코드가 깨끗하면 AI 코딩 에이전트도 일을 더 잘할까?

AI한테도 '깨끗한 코드'가 중요할까?

요즘 코딩 에이전트, 많이들 쓰시죠. 클로드 코드나 커서 같은 도구한테 "이 기능 좀 고쳐줘" 하면 알아서 파일 뒤져보고 코드 짜주는 시대잖아요. 그런데 여기서 재미있는 질문이 하나 나와요. 사람이 읽기 좋은 '깨끗한 코드'가 AI 에이전트한테도 도움이 될까? 아니면 AI는 사람과 달라서 지저분하든 말든 상관없이 잘 해낼까? 이번에 나온 한 연구가 바로 이 질문을 정면으로 파고들었어요.

배경부터 짚어볼게요. '코드 클린리니스(code cleanliness)', 우리말로 '코드 청결도'라고 하면요, 변수 이름을 알아보기 쉽게 지었는지, 함수가 너무 길거나 복잡하지 않은지, 중복이 없는지, 테스트와 주석이 잘 갖춰져 있는지 같은 걸 말해요. 사람 개발자한테 좋은 코드가 중요한 이유는 명확하죠. 읽기 쉬우면 이해가 빠르고 실수가 줄거든요. 그런데 AI 에이전트는 사람처럼 '피곤해서 못 읽겠다'는 게 없으니까, 어쩌면 청결도 따위 신경 안 써도 되는 거 아니냐는 생각이 들 수 있어요.

결과는 '사람과 크게 다르지 않다'

연구가 던지는 핵심 메시지는, AI 에이전트도 결국 깨끗한 코드에서 더 일을 잘한다는 거예요. 곰곰이 생각해보면 당연한 면이 있어요. 코딩 에이전트는 코드를 '텍스트'로 읽고 문맥을 파악해서 다음 행동을 결정하는데, 이 문맥이라는 게 한정된 창(컨텍스트 윈도우)에 담겨요. 변수 이름이 a, b, tmp처럼 모호하거나, 함수 하나가 500줄씩 뒤엉켜 있으면, 에이전트도 '지금 이 코드가 뭘 하는 건지' 파악하는 데 더 많은 정보를 소모하고 더 자주 헷갈려요. 반대로 이름만 봐도 역할이 드러나고, 구조가 잘 쪼개져 있으면, 필요한 부분만 정확히 찾아서 고칠 수 있죠.

특히 영향을 크게 받는 건 '이 코드가 뭘 의도했는지'를 코드 밖에서 알 방법이 없을 때예요. 사람이라면 옆자리 동료한테 물어보거나 커밋 히스토리를 뒤지지만, 에이전트에게는 주어진 코드와 이름, 테스트가 사실상 전부거든요. 그래서 좋은 네이밍과 테스트가 사람보다 오히려 에이전트한테 더 결정적인 단서가 되기도 해요.

무엇을 바꿔야 하나

이게 실무에 주는 함의가 커요. 지금까지 우리는 코드 정리를 '사람을 위한 배려' 정도로 여겼잖아요. 그런데 이제는 AI 에이전트라는 새로운 '독자'가 하나 더 생긴 셈이에요. 리팩터링, 명확한 이름, 작은 함수, 충실한 테스트 — 이런 것들이 단순한 미덕이 아니라 'AI가 내 코드베이스에서 얼마나 삽질 없이 일하느냐'를 좌우하는 실질적 성능 요인이 된 거죠. 반대로 기술 부채가 잔뜩 쌓인 레거시 코드에서는 사람도 AI도 똑같이 고생한다는 뜻이기도 해요.

한국 개발자에게

당장 써먹을 수 있는 교훈이에요. AI 도구를 팀에 도입했는데 생각보다 결과가 별로라면, 도구 탓만 하기 전에 '우리 코드베이스가 애초에 읽기 좋은가'를 돌아볼 필요가 있어요. 에이전트가 잘 물어가는 코드를 만드는 게, 어쩌면 더 비싼 모델을 쓰는 것보다 가성비 좋은 투자일 수 있거든요. 또 신입 교육이든 코드 리뷰든, '깨끗한 코드'를 강조할 명분이 하나 더 늘었어요. 이제는 "사람이 읽기 좋으니까"에 더해 "AI도 잘 도와주니까"라고 말할 수 있잖아요.

한 줄로 정리하면, 깨끗한 코드는 사람뿐 아니라 AI 에이전트한테도 좋은 코드라는 거예요. 여러분 팀의 코드베이스는 AI가 들어와서 일하기에 친절한 편인가요, 아니면 사람도 AI도 함께 헤매는 편인가요?