[개발 일기] AI 워크 플로우(1) - 초기 세팅
Claude와 Codex
최근에 Codex를 사용하다가 성능이 별로인거 같아서 Claude로 갈아탔다. 근데 Codex 만료 기간이 좀 남아서 Claude 작업에 검토를 해주는 흐름을 만들어봤다. 원래는 이슈 몇 개 처리하는거 보고 글 적으려고 했는데, 오늘 블로그 주제가 딱히 안떠올라서 그냥 간단하게 글 썼다.
일단 메인을 Claude, 서브를 Codex로 정했고 아래와 같은 일을 한다.
- Claude: 작업 계획,구현, 검증, gh 작업
- Codex: 작업 계획 검증, 회귀 테스트 항목 및 코드 구현, 코드 리뷰
흐름
Claude 계획 → Codex 계획 검토 → 사람 승인 → Claude 구현
→ Codex 변경 리뷰·테스트 작성 → Claude 검증 → PR → 사람 병합
- 계획: Claude가 작업 계획을 쓴다.
- 계획 검토: Codex가 계획을 읽고 문제를 찾는다. 파일은 수정하지 않는다. 결과는 "차단 이슈"와 "추가 제안" 두 가지로만 낸다. 문제가 없으면 바로 계획 보고 하고, 문제가 있으면 1번으로 돌아간다.
- 승인: 사람이 계획을 보고 승인한다.
- 구현: Claude가 기능 코드를 쓴다.
- 리뷰·테스트: Codex가 바뀐 코드를 리뷰하고 검증할 수 있는 코드를 작성한다. 새로운 기능에 대한 최소한의 검증, 새로운 기능으로 인해 문제가 발생할 수 있는 테스트 코드를 작성한다.
- 검증: Claude가 테스트를 실행하고 통과·실패를 판정한다.
- PR: 통과하면 Claude가 PR을 올리고, 사람이 직접 확인한 뒤 병합한다.
검증에 실패하면 Claude가 로그를 Codex에게 넘긴다. Codex는 실패 원인이 기능 버그인지 테스트 문제인지 가려낸다. 기능 버그는 Claude가, 테스트 문제는 Codex가 고친 뒤 다시 검증한다. 재검증은 최대 2번까지만 하고, 그래도 실패하면 사람에게 넘긴다.
왜 이렇게 했나
만든 쪽이 검사하지 않게 했다.
기능 코드는 Claude가 쓰고, 그 코드를 검사하는 테스트는 Codex가 쓴다. 또한 Codex가 작성한 테스트 코드에 대한 리뷰는 Claude가 해준다. 같은 AI가 코드 작성하고 테스트까지 해버리면 빈틈을 똑같이 놓칠 수 있을거라고 생각했기 때문이다.
서로의 영역을 건드리지 못하게 했다. Codex는 기능 코드를 고칠 수 없고, Claude는 테스트 코드를 직접 고칠 수 없다. 테스트 기대값을 바꿀 때는 원래 값이 왜 틀렸는지 근거를 적어야 한다. 테스트를 고쳐서 버그를 덮는 일을 막기 위해서다.
사람은 판단만 한다. 사람이 개입하는 지점은 계획 승인과 최종 병합 두 곳이다. Codex의 지적도 정말 막아야 할 문제(차단 이슈)와 참고할 의견(추가 제안)으로 나눠서, 사람이 볼 것만 올라오게 했다.
실행은 한쪽에 모았다. Codex 실행 환경에서는 Unity와 GitHub CLI를 쓸 수 없어서, 실행과 커밋·PR은 모두 Claude가 맡는다. Codex는 읽고, 판단하고, 테스트 코드를 쓰는 일에만 집중한다.
느낀점
아직 실제 작업을 들어가진 못해서 위에서 설정해놓은 워크 플로우가 제대로 돌아가는지 잘 모르겠지만, 뭔가 든든한 팀원들이 생긴 느낌이다. 뭔가 AI를 통해 자동화를 시켜서 효율적으로 작업하고 싶은데, 이게 뭔가 첫 걸음이 되는 것 같다. 당연히 처음부터 완벽히 잘 돌아가는 워크플로우를 만들 생각은 없고, 작업하면서 계속 수정하고 다듬어서 최적의 워크플로우를 만드는게 목표다. 개발하다가 수정하는 워크플로우가 있으면 조금씩 기록해보려고 합니다.


