Codex나 Claude Code에 실제 작업을 맡기는 예시로, 예측 모델을 만드는 과정까지를 Kindle 도서 『AI 에이전트로 머신러닝을 스킬로 만들기』에 정리했습니다. 오늘(11월 16일) 오후 5시까지 무료로 읽으실 수 있습니다.
마지막 회차입니다. 제6회 마지막에서 "이 연재 역시 사실 두 개의 AI에게 역할을 나누어 만들었습니다. 그 비하인드 스토리는 제8회에서"라고 예고했습니다. 이번에는 그 비밀을 밝히며 연재를 마무리합니다.
이 연재의 원고는 제5회부터 GitHub 리포지토리 위에서 작성해 왔습니다. Issue로 요청 기록을 남기고, 브랜치(Branch)로 작성하며, 풀 리퀘스트(Pull Request)로 확인한 후 병합(Merge)하는 과정을 그대로 원고 제작에 사용했습니다.
리포지토리는 비공개라 직접 보실 수는 없습니다. 대신 남아있는 기록을 본문에 인용하겠습니다. 날짜나 번호는 모두 기록과 같습니다.
등장하는 것은 저(저자)와 제7회에서 소개한 두 개의 AI 도구입니다.
| 담당 | 수행 내용 |
|---|
| 저자 | 회차별 테마와 방침을 결정. AI 리뷰의 지적 사항을 수용할지 여부를 결정. 병합(Merge) 버튼 누르기 |
| ... | |
| 원고의 개요 상담이나 원고 낭독에는 채팅 AI도 사용했습니다. | |
숫자로 보면 다음과 같습니다. 리포지토리를 만든 10월 17일부터 제7회를 병합한 11월 14일까지의 기록입니다.
- 연재를 위해 생성된 Issue는 총 6건, 풀 리퀘스트(Pull Request)도 6건이 있었습니다.
- 원고 및 편집 메모 기록(커밋, Commit)은 15건. 모두 Claude Code가 작성했거나, Claude Code와 공동으로 작성한 것입니다.
- Codex의 자동 리뷰 지적 사항은 4건. 그중 3건은 본문을 수정했고, 1건은 이유를 적어 보류했습니다.
- 병합(Merge)은 총 6건. 모두 저자가 직접 눌렀습니다.
제5회부터 원고 문장을 작성한 것은 주로 Claude Code였습니다. 반면, 제6회의 병합은 AI에게 단 한 번도 맡기지 않았습니다.
작성 역할과 확인 역할을 다른 AI에게 분리한 데는 이유가 있습니다. 자신이 쓴 것을 스스로 확인하면 놓치는 부분이 생기기 쉽기 때문입니다. 사람 팀에서 '작성자'와 '확인자'를 나누는 것과 같은 생각입니다. AI 역시, 작성 본인이 검토하는 것보다 다른 AI에게 읽게 하는 것이 여러 각도의 지적 사항을 돌려받을 수 있습니다.
잘된 경우만 나열해도 비밀이 풀리는 것은 아닙니다. 실패했던 경우까지 포함하여 4가지를 소개합니다.
제5회 원고를 공개한 것은 10월 18일 아침입니다. 풀 리퀘스트를 만든 지 5분 만에 저는 병합(Merge)했습니다.
그 사이에 Codex의 리뷰가 1건의 지적 사항을 남겼습니다.
Issue에서는 '담당 부서를 작성'과 '연락 방법을 작성' 두 항목을 요청했지만, 이 절차로 README에 추가하는 것은 부서명만입니다. 그런데도 마지막에는 두 가지 모두 체크하도록 안내하고 있었습니다.
지적 사항을 깨달은 것은 병합(Merge)한 후였습니다. 다시 Issue #3을 생성하여 다른 풀 리퀘스트(#4)로 수정했습니다. 원래 지적 사항에는 '수정은 다음 풀 리퀘스트에서 진행했습니다'라는 내용과 함께 수정한 위치 링크를 첨부하여 답변했습니다.
제4회에서 정리된 지적 사항은 'Resolve conversation(해결됨으로 처리)'로 닫는 것이 좋다고 소개했습니다. 미해결 지적 사항만 남기 때문에 확인 누락을 막을 수도 있다고도 적었습니다. 바로 그 확인 과정을 거치지 않고 병합했던 것이 이 상황입니다. 병합 버튼을 누르기 전에 Conversation 탭에 미해결 지적 사항이 남아있지 않은지 보는 것. 작성 본인이 얻은 가장 중요한 교훈입니다.
제6회에서는 같은 흐름이 잘 돌아갔습니다. Codex의 지적은 다음과 같습니다.
GitHub Desktop이 백그라운드에서 가져오기(Fetch)를 완료한 후, 브라우저에서 변경하고 돌아왔을 때 버튼은 이미 'Pull origin' 상태여서 이 'Fetch origin'을 누르는 절차를 실행할 수 없습니다.
본문에는 'Fetch origin을 누르면 버튼이 Pull origin으로 바뀐다'는 전제 하에 작성되어 있었습니다. 실제로는 처음부터 Pull origin이 표시되는 경우가 있습니다. Claude Code가 '이미 버튼이 Pull origin 상태인 경우에는 그대로 눌러주세요'라는 문장을 추가하여 기록하고, 지적 사항에 답변했습니다.
지적해 주셔서 감사합니다. 155727f의 수정으로 대응했습니다.
는 그 수정 기록(commit)에 붙은 번호입니다. 번호가 있기 때문에 어떤 수정으로 대응했는지 나중에 누구나 추적할 수 있습니다. 지적, 수정, 회신, 해결됨. 제4회에서 소개한 흐름의 교본 같은 왕복이었습니다.
제4회부터 제6회의 화면 이미지는 Codex에게 촬영을 부탁했습니다. 연습용 work-notes 리포지토리에서 실제로 조작하고, 화면을 캡처하며, 버튼 표기가 본문과 일치하는지 표로 정리하여 보고하도록 요청한 것입니다.
제5회의 보고서에는 다음과 같은 문구가 있었습니다.
'지정된 필수 조건을 충족하지 못했기 때문에 완성본으로 게재하는 것은 권장하지 않습니다. (중략) 화면의 합성이나 문자 재작성은 진행되지 않았습니다.'
6장의 이미지 중 1장은 버튼 글자가 중간에 잘려 있었습니다. Codex는 이를 숨기지 않고, 사용하지 않는 것이 좋다고 적었습니다. 이런 보고가 있으면 사람은 판단에 집중할 수 있습니다.
제6회에서는 촬영 자체가 멈추었습니다. Codex가 GitHub Desktop의 로그인 과정을 끝까지 완료하지 못했고, 비공개 work-notes를 클론 할 수 없었기 때문입니다. 여러 번 시도해 보도록 요청했지만, 저는 촬영을 중단하기로 결정했습니다. 제6회의 이미지가 단 1장인 이유가 그것입니다. 절차는 문장만으로 추적할 수 있도록 Claude Code에게 다시 작성하도록 했습니다.
중간 보고에서도 수확은 있었습니다. Codex가 본 Windows 화면에서 클론 저장소의 초기값이 OneDrive 내부 폴더였던 것입니다. 제6회의 '동기화 폴더는 피하라'는 주의사항에, '필자의 Windows에서는'이라는 실제 사례를 추가할 수 있었던 것이 이 보고 덕분입니다.
제7회는 AI에게 작업을 맡길 때의 '요청'과 '열쇠(키)'에 대한 이야기였습니다. Claude Code 설정에서 .env 파일을 읽지 못하게 할 수 있다는 부분에, Codex가 가장 무거운 지적(P1)을 했습니다.
읽기 거부 규칙만으로는 비밀 파일을 격리할 수 없음을 명시하기
읽지 못하게 하는 설정이 막는 것은 Claude Code가 직접 파일을 읽는 작업뿐입니다. 다른 프로그램을 통해 읽는 경로는 남아 있습니다. 열쇠의 중요성을 다룬 글에서, 열쇠의 허점을 또 다른 AI가 발견한 것입니다. 이 지적을 수용하여 본문에 '읽지 못하게 하는 설정에도 허점이 있어, 두지 않는 것의 대안이 될 수 없다'고 추가했습니다.
같은 리뷰에는 또 하나의 지적이 있었습니다. 각주에 있는 Codex의 일본어 페이지가 열리지 않는다(404)는 것입니다. 브라우저로 다시 열어보니, 어느 쪽 페이지도 문제없이 표시되었습니다. 그래서 본문은 수정하지 않고, 확인한 날짜와 결과를 적어 회신했습니다.
AI의 지적이라도 그대로 받아들일 수는 없습니다. 확인하고, 수용할지 보류할지를 결정해야 합니다. 보류했을 때는 이유를 남겨야 합니다. 제7회의 '판단은 받는 쪽의 일'이라는 내용을, 리뷰를 받는 측면에서도 실천한 장면입니다.
제1회에서는 회의까지 10분 전인 사토 씨를 그렸습니다. 손에는 모든 파일이 갖춰져 있지만, 어떤 것을 사용해야 할지 판단할 수 없는 상황이었습니다. 부족했던 것은 파일들 간의 관계를 보여주는 기록이라는 이야기였습니다. 그때 언급된 5가지 질문에, 연재에서 다룬 도구들을 적용하면 다음과 같습니다.
| 제1회의 질문 | 답을 주는 도구 | 다룬 회차 |
|---|
| 이번에 사용해야 할 버전은 무엇인가 | main (리포지토리 본체) | 제3회, 제4회 |
| ... | | |
이 연재의 리포지토리에도 5가지 답이 그대로 남아 있습니다. 제5회의 연습 절차가 왜 바뀌었는지는 PR #2의 지적과 PR #4의 수정에서 알 수 있습니다. 제7회의 '허점'이라는 문구가 언제, 왜 들어갔는지도 PR #13 기록에 적혀 있습니다.
제1회에서 다음과 같은 가설을 세웠습니다.
GitHub의 기초는 과거 엑셀처럼 비즈니스맨의 업무 기술 중 하나가 되어가는 것이 아닐까?
8회를 마치고, 가설은 여전히 가설입니다. 그럼에도 불구하고 성과는 있었습니다.
이 연재에서 가장 많이 손을 움직인 것은 AI였습니다. 원고를 쓴 것도, 화면을 찍은 것도, 리뷰한 것도 주로 AI였습니다. 제가 한 일은 요청서를 작성하는 것, 차이점(diff)과 지적을 읽는 것, 그리고 그것을 수용할지 결정하는 것입니다. 이 모든 것에 코드를 작성하는 능력은 필요하지 않습니다. 그럼에도 불구하고, 여기서 사람이 손을 놓으면 PR #2처럼 확인하지 않은 채로 받아들이게 됩니다.
AI가 움직이는 시대의 GitHub 기술은 조작법을 익히는 것보다 기록을 읽고 판단하는 것에 가깝다고 생각합니다. 엑셀 함수를 모두 외우지 못해도, 표의 숫자가 이상하다는 것을 알아차릴 수 있는 사람이 신뢰받아 왔던 것과 같습니다.
제1회에서 작성했듯이, 이것은 GitHub라는 특정 서비스에 관한 이야기가 아닙니다. 요청을 기록하고, 변경 사항을 초안으로 제시하며, 확인한 후 통합하는 이 흐름은 어떤 도구를 사용하더라도 적용할 수 있습니다.
이 연재는 제가 집필한 Kindle 책의 서론 격으로 시작되었습니다.
『AI 에이전트로 머신러닝을 스킬로 만들기』
【부동산 감정사가 가르치는, Codex 및 Claude Code를 활용하여 예측 모델을 만드는 AI 코딩 입문】
본서에서는 비엔지니어 주인공이 AI 도구(본문은 Codex, 부록은 Claude Code)와 함께 중고 아파트의 거래 가격을 설명하는 예측 모델을 만들고, 이를 '스킬'로 완성합니다. GitHub 사용법은 책에 담지 않고 이 연재물에 맡겼습니다.
책에서 사용하는 코드 일체와 교재 데이터는 GitHub 공개 리포지토리(signal-yield/ml-skill-book)에서 배포하고 있습니다. 제6회에서 연습했던 클론을 그대로 사용할 수 있으며, 제7회의 '요청'과 '키' 역시 책의 작업에 바로 유용할 것입니다.
11월 16일 (월) 16:59 (일본 시간)까지 Kindle에서 무료로 읽으실 수 있습니다. 그 이후에도 Kindle Unlimited 회원이라면 추가 비용 없이 이용 가능합니다.
8회에 걸쳐 함께해 주셔서 감사합니다. 처음에는 '모르는 웹 서비스에 결과물을 올릴 이유가 무엇인지 모르겠다'는 전제로 시작했던 연재였습니다. 이 글이 어딘가의 사토 씨가 회의 전에 겪는 10분의 시간을 조금이라도 편하게 만드는 데 도움이 되기를 바랍니다.