코딩하는 AI - 모델·하네스·작업 화면을 구분하기

이 장에서 배우는 것

자동완성·채팅·에이전트를 작업 단위로 구분하고 모델·하네스·IDE의 세 층을 변경 기록으로 설명한다.

버그 하나를 고치는 세 가지 방식

교재 전체에서는 가상의 도서 대출 CSV를 요약하는 도구를 만든다고 가정한다. 빈 파일을 읽으면 평균 계산에서 0으로 나누는 버그가 있다. 자동완성은 편집 중인 함수의 다음 줄을 제안한다. 채팅은 사람이 붙여 넣은 코드와 오류를 보고 수정안을 답한다. 에이전트 방식에서는 허용된 범위 안에서 파일을 읽고, 변경하고, 검사를 실행하는 과정까지 이어질 수 있다. 이 분류는 제품 순위가 아니라 이 책의 작업 단위 정의다. 같은 제품 안에서도 세 방식이 섞일 수 있다.

자동완성으로 받은 한 줄이라도 저장하고 실행할 책임은 남는다. 채팅에 코드를 붙여 넣었다면 누락한 호출부 때문에 잘못된 수정안이 나올 수 있다. 에이전트가 테스트를 실행했다고 해도 해당 테스트가 빈 파일을 다루지 않으면 버그가 남는다. 화면에 완료라는 문장이 떴는지보다 어떤 입력으로 어떤 결과를 확인했는지 기록한다.

세 층을 나누면 원인을 찾기 쉽다

모델은 주어진 입력을 처리해 응답이나 도구 호출 요청을 만든다. 하네스는 그 요청을 실제 도구와 연결하고 결과를 다음 입력으로 전달하는 실행 환경을 뜻한다. IDE나 터미널은 사람이 작업을 지시하고 변경을 보는 화면이다. 이 구분은 교재의 설명 틀이며 제품이 공식적으로 같은 용어를 쓰는 것은 아니다. 모델을 바꾸는 설정과 파일 쓰기 권한을 바꾸는 설정은 서로 다른 층에 있다.

파일을 못 고치는 일이 생기면 먼저 편집 도구가 연결되어 있는지, 작업 폴더가 맞는지, 쓰기 권한이 있는지 확인한다. 모델 이름만 바꿔 보는 것은 원인을 좁히지 못한다. 반대로 변경은 됐지만 경계 조건을 빠뜨렸다면 요구와 검사 사례를 보강해야 한다. 어느 층에서 문제가 발생했는지 나누면 지원 요청도 구체적으로 쓸 수 있다.

관찰 기록을 남기는 이유

연습에서는 같은 버그를 서로 다른 방식으로 다룬 뒤 사람이 한 일을 센다. 파일을 찾아 복사했는지, 수정안을 붙여 넣었는지, 테스트 명령을 직접 실행했는지 적는다. 도구가 대신한 단계와 사람이 확인한 단계를 따로 적어야 한다. 한 번의 실험으로 특정 제품이 항상 빠르다고 결론 내릴 수는 없다. 준비 시간과 기존 경험이 결과에 섞이기 때문이다.

이 책에서 제품 설명의 확인일은 2026-11-08이다. 요금·모델 순위·추정 사용률은 싣지 않는다. 설치 화면이 달라져도 요구, 변경, 검사라는 관찰 단위는 유지할 수 있다. 도구별 사용법이 바뀌면 부록 B의 방법으로 공식 문서를 다시 확인한다.

직접 해 보기

대출 요약 도구의 빈 파일 버그를 고친다는 요청문을 쓴다. 자동완성·채팅·에이전트 중 사용 가능한 방식 두 개로 작업하고, 파일 찾기·수정·검사·검토의 담당자를 표로 남긴다. 유료 가입이나 서버 접속은 필요 없다.

해설과 확인 기준

예시 기록은 채팅에서 사람이 파일 두 개를 전달하고 수정안을 적용한 뒤 검사를 실행한 경우다. 에이전트 방식에서는 파일 탐색과 검사 실행을 도구가 했어도 사람은 빈 입력 검사와 diff를 읽는다. 둘 다 검사가 없다면 완료로 표시하지 않는다. 도구가 출력한 성공 문장과 실제 종료 코드가 다른지도 확인한다.

근거와 기준일

제품·자료 확인일: 2026-11-08. 설명 틀·대출 도구·연습·해설은 교재의 자체 구성이다. 제품별 세부 조건은 아래 공식 문서에서 해당 실행 방식과 계정 범위를 다시 확인한다.

• Claude Code 개요
• Codex 프로젝트 지침