한 달 동안 클로드 코드와 코덱스를 같은 저장소에 두고 실무에 적용해 보았습니다. 소문으로만 듣던 에이전트 병용이 실제로 얼마나 생산성을 높여주는지 확인하고 싶었습니다. 직접 겪어본 시행착오를 바탕으로 효율적인 셋업 방식을 공유합니다.

작성과 검토의 논리적 격리

클로드 코드가 코드를 짜면 코덱스가 옆에서 훈수를 두는 구조를 만들었습니다. 같은 모델에게 리뷰를 맡기면 자기 가정을 그대로 답습하는 경향이 있어 모델을 분리하는 것이 중요합니다. 한쪽이 쓴 가정을 다른 쪽이 의심하는 환경을 조성하니 사각지대가 눈에 띄게 줄었습니다.

리뷰어에게 절대 차단 권한을 주지 않는 것이 운영의 묘미입니다. 코덱스가 오류를 찾아내도 푸시 자체는 통과시켜야 작업 흐름이 끊기지 않습니다. 차단이 발생하는 순간 모델의 오탐지로 인해 전체 공정이 멈추고 개발자는 도구를 우회하게 됩니다.

설정 파일의 차별적 구성

작성자용과 리뷰어용 설정 파일을 완전히 다르게 구성해야 합니다. 구현 방법과 스타일을 담은 파일과 별개로 검증 항목만 명시한 파일을 따로 둡니다. 두 파일의 내용이 비슷하면 역할 분담이 제대로 되지 않고 있다는 신호로 봐야 합니다.

파일 패턴과 인라인 정규식은 별도의 보호 장치로 활용합니다. 보안 관련 파일은 즉시 중단시키되 모델의 분석 결과는 경고 수준으로 유지합니다. 보안 사고 예방과 품질 개선은 층위가 다르기에 명확한 구분이 필요합니다.

작업 성격에 따라 도구를 선택하는 기준을 세웠습니다. SQL 수정이나 결제 로직처럼 민감한 변경은 반드시 교차 검토를 거치게 설계했습니다. 래퍼 스크립트로 호출을 관리하며 항상 정상 종료 상태를 유지해 워크플로우를 안정화했습니다.

운영 효율과 보안 자동화

파일 변경량이 많아지면 실행 명령어를 상황에 맞게 전환합니다. 깃 정보를 직접 읽는 방식은 깔끔하지만 대규모 작업에서는 자원 소모가 큽니다. 변경된 부분만 골라 전달하는 방식으로 효율을 높이는 유연함이 요구됩니다.

이중 구조를 도입한 뒤 머지 직전에 잡히는 버그가 확실히 늘어났습니다. 클로드가 자신 있게 짠 코드에서 코덱스가 레이스 컨디션을 찾아내는 식입니다. 자기 코드를 다시 들여다보는 피로가 줄어들며 동료 리뷰어와 함께 일하는 기분을 느꼈습니다.

작업을 마치고 다음 날 코드를 다시 열어보며 후회하는 일이 줄었습니다. 다른 시각이 한 번 거쳐 간 덕분에 회귀 검토에 드는 에너지가 아껴집니다. 여러 시각을 확보하는 과정이 코드 품질의 근간이 됩니다.

요약

  • 동일 모델의 셀프 리뷰보다 서로 다른 모델을 작성자와 리뷰어로 분리하는 것이 논리적 맹점 파악에 유리합니다.
  • Advisory 리뷰어는 절대 작업을 차단(block)하지 않아야 워크플로우 오염과 hook 우회를 방지할 수 있습니다.
  • 작성자용(CLAUDE.md)과 리뷰어용(AGENTS.md) 컨텍스트 파일을 다르게 구성하여 모델의 관점을 강제로 분리해야 합니다.