ChatGPT나 Claude 웹에서 코드를 물어보는 것과 Claude Code 같은 코딩 에이전트를 프로젝트 안에서 실행하는 것은 비슷해 보이지만 사용 경험이 꽤 다릅니다.
채팅에서는 보통 코드를 복사해 보여주고 답을 받습니다. 코딩 에이전트는 저장소를 직접 탐색하고, 파일을 수정하고, 명령을 실행할 수 있습니다.
‘답변’보다 ‘작업’에 가깝습니다
예를 들어 “로그인 오류를 고쳐줘”라고 요청했을 때 채팅형 AI는 필요한 코드를 물어보거나 예시를 줍니다. 코딩 에이전트는 프로젝트 안에서 관련 파일을 찾고 변경점을 만들 수 있습니다.
그래서 사용자는 프롬프트 작성자만이 아니라 작업을 맡기고 검토하는 사람이 됩니다.
프로젝트 맥락이 중요해집니다
에이전트가 실제 파일을 건드리기 때문에 프로젝트 규칙, 실행 방법, 수정하지 말아야 할 영역 같은 정보가 중요합니다. 작은 개인 프로젝트에서는 없어도 버틸 수 있지만 저장소가 커질수록 차이가 커집니다.
이 부분은 하네스 엔지니어링의 기본 개념과도 연결됩니다.
모든 것을 한 번에 맡기지 마세요
AI가 파일을 직접 수정할 수 있다는 이유로 “전체 서비스를 완성해줘”처럼 거대한 요청을 한 번에 던지면 검토하기가 어려워집니다. 작은 단위로 목표를 나누고 변경사항을 확인하는 편이 안전합니다.
개발자가 확인할 기본 질문은 여전히 같습니다.
- 왜 이 파일을 바꿨는가?
- 예상하지 않은 범위가 수정되지는 않았는가?
- 테스트나 빌드는 통과하는가?
- 변경 내용을 되돌릴 수 있는가?
코딩 에이전트는 개발 지식을 없애기보다 역할을 바꿉니다
문법을 직접 입력하는 시간은 줄 수 있지만, 무엇을 만들지 정하고 결과가 맞는지 판단하는 일은 더 중요해집니다. 특히 기존 코드베이스에서는 시스템의 구조를 이해할수록 AI 결과를 빠르게 검토할 수 있습니다.
Claude Code를 잘 쓰는 첫걸음은 숨겨진 마법 명령을 많이 아는 것이 아니라, AI가 실제 프로젝트에서 어떤 권한으로 어떤 일을 하는지 이해하는 것입니다.