출판사로부터 도서를 제공받았습니다

클로드 코드에만 갇혀 있던 나에게 던진 질문

매일 터미널에 claude를 입력하고 작업을 시작한다. 클로드 코드 하나만으로도 충분히 만족스러웠다. 그런데 어느 순간부터 "코덱스 CLI는 또 뭐가 다른 걸까?"라는 궁금증이 생겼다. 둘 다 터미널에서 코드를 짜주는 에이전틱 AI라는데, 굳이 두 개를 다 써야 할 이유가 있을까? 이 질문에 답을 찾으려고 집어든 책이 바로 《AI 자율학습 클로드 코드·코덱스 CLI 완전 활용법》(데이브 리, 길벗)이다.

결론부터 말하면, 클로드 코드만 써본 사람에게 딱 필요한 책이었다. 이 책은 처음부터 끝까지 "두 도구 중 뭘 써야 하지?"라는 질문에 명확한 기준을 제시해준다. 그 내용을 경험에 비춰 정리해본다.

클로드 코드 vs 코덱스 CLI, 뭐가 다른가

책의 1장부터 "클로드 코드와 코덱스 CLI 선택하기"라는 소절이 등장한다. 처음 읽을 때는 "이게 왜 1장부터 나오지?" 싶었는데, 읽다 보니 이해가 됐다. 두 도구는 겉보기엔 비슷해도 설계 철학 자체가 다르다.

클로드 코드는 "넓게 쓰는" 도구다.

터미널뿐 아니라 VS Code 공식 확장, 웹, 모바일, 심지어 브라우저를 직접 조작하는 Computer Use까지 작업 영역이 넓다

CLAUDE.md 파일 하나로 프로젝트 규칙과 메모리를 관리한다

확장 사고(Effort 조절)로 작업 난이도에 맞춰 깊이 있게 사고한다

복잡한 코드베이스를 다룰 때 문맥 이해력이 뛰어나다는 평가가 많다

코덱스 CLI는 "엄격하게 통제하는" 도구다.

codex exec라는 비대화형 실행 방식이 핵심이다. 사람이 옆에 없어도 스크립트처럼 돌아간다

샌드박스 기반으로 실행 범위, 웹 접근, 승인 방식을 꼼꼼하게 제한한다

AGENTS.md와 config.toml로 지침과 설정을 분리해서 관리한다

백그라운드 작업과 예약 작업을 분리해서 자동화 루틴을 돌리기 좋다

이 책을 읽고 나서야 왜 내가 클로드 코드만 쓰면서도 가끔 답답함을 느꼈는지 알게 됐다. 반복적인 테스트 자동화나 CI 파이프라인처럼 "사람 개입 없이 돌아가야 하는 작업"은 애초에 클로드 코드의 설계 철학과 맞지 않았던 거다. 이런 영역은 코덱스 CLI가 훨씬 적합하다.

각 도구의 장단점, 선택 전에 꼭 알아야 할 것

클로드 코드만 써본 사람이라면 "장점"은 익숙해도 "단점"은 체감하기 어렵다. 책에서 정리한 내용과 내 경험을 더해보면 이렇다.

클로드 코드는 작업 범위가 넓고 유연한 대신, Effort 조절이나 모델 선택에 따라 토큰 소비와 과금 관리에 신경 써야 한다. 대화형으로 깊게 파고드는 만큼 비용도 그에 비례해서 올라간다.

코덱스 CLI는 샌드박스와 비대화형 실행이 강력한 대신, GUI나 웹/모바일 같은 외부 인터페이스 연계가 약하다. 터미널과 CLI 환경에 익숙하지 않다면 초반 진입 장벽이 클로드 코드보다 높게 느껴질 수 있다.

결국 둘은 경쟁 관계가 아니라 보완 관계라는 게 책의 핵심 주장이다. 하나만 붙잡고 있던 나에게는 이 지점이 가장 크게 다가왔다.

가장 매력적이었던 Part 7, 둘을 "같이" 쓰는 법

이 책을 읽은 진짜 이유가 여기에 있다. 단순히 두 도구를 비교하는 걸 넘어서, 실제로 어떻게 역할을 나눠서 같이 쓰는지를 보여주는 부분이다.

19장에서는 바이브 코딩으로 간단한 웹 페이지를 빠르게 만들고, 요구 사항과 검증 기준을 명확히 세운 뒤 GitHub에 배포하는 과정을 다룬다. 자연어로 "이런 분위기의 페이지를 만들어줘"라고 던지면 AI가 파일 생성부터 로컬 서버 실행까지 알아서 처리하는 방식이다.

20장은 한 단계 더 들어간다. 바이브 코딩만 믿으면 "A를 고치면 B가 깨지는" 퇴행 현상이 반드시 생긴다는 걸 짚으면서, 하네스(Harness)라는 개념을 소개한다. 말에게 씌우는 마구처럼, AI가 정해진 규칙 안에서만 움직이도록 감싸는 안전망이라는 비유가 와닿았다. CLAUDE.md와 AGENTS.md에 규칙을 못 박고, 린터와 테스트를 "통과 못 하면 완료 아님"으로 강제하는 구조다.

그리고 루프 엔지니어링. 실행하고, 검증하고, 실패하면 에러 로그를 AI가 직접 읽고 스스로 고친 뒤 다시 검증하는 폐루프를 설계하는 기술이다. 이 흐름에서 역할 분담이 명확하게 그려진다.

기획과 설계, 대화형 바이브 코딩은 클로드 코드가 맡는다

비대화형 자동 검증과 반복 실행은 코덱스 CLI의 codex exec가 맡는다

한 도구가 특정 버그에 갇혀 못 빠져나올 땐 다른 도구로 세션을 열어 교차 검증한다

이 부분을 읽고 나서야 "두 도구를 왜 같이 써야 하는지"가 완전히 이해됐다. 단순한 양자택일이 아니라, 각자의 강점을 살려 하나의 작업 체계 안에 엮어내는 설계도였던 거다.