하네스 비교 - 같은 질문으로 공식 문서 읽기

이 장에서 배우는 것

Codex·Claude Code·Cursor·Copilot·Antigravity를 동일한 확인 항목으로 조사하고 미확인 상태를 관리한다.

비교 단위부터 통일한다

하네스 비교에서 한쪽의 CLI와 다른 쪽의 클라우드 제품을 같은 것으로 취급하면 조건이 어긋난다. 도구 이름 뒤에 어느 실행 방식을 비교했는지 적는다. 이 장은 설치 설명서가 아니라 근거를 수집하는 연습이다. 버전과 계정에 따라 달라질 수 있는 기능은 문서 확인과 실제 시험을 나눈다.

공통 질문은 프로젝트 지침을 어디서 읽는가, 파일과 네트워크의 범위를 어떻게 제한하는가, 외부 도구를 어떻게 연결하는가, 비대화형 실행 결과를 어떻게 회수하는가, 분담 작업을 어떻게 검증하는가다. 특정 도구가 한 항목을 지원해도 내 계정과 실행 방식에서 가능한지는 별도 시험이 필요하다.

이번에 확인한 지침의 입구

Codex의 프로젝트 지침은 AGENTS.md 문서에서, Claude Code는 CLAUDE.md 문서에서 출발한다. Cursor의 프로젝트 규칙은 .cursor/rules의 .mdc 형식이며 GitHub Copilot의 저장소 전체 지침은 .github/copilot-instructions.md에서 출발한다. 이는 2026-11-08 확인한 문서의 입구다. 여기서 각 도구가 지원하는 다른 지침 파일을 모두 열거한 것은 아니다.

CLI 자동화와 하위 에이전트 항목은 제품별 세부 문서를 추가로 읽어야 한다. 이 장의 간단한 표에서 미확인이라는 표시는 미지원이라는 판정이 아니다. 미확인 항목을 억지로 예 또는 아니오로 채우지 않는 것도 조사 결과다. 팀 필수 조건에 해당하면 확인이 끝날 때까지 선택 근거로 사용하지 않는다.

제품 변경과 계정 정책을 구분한다

Gemini CLI와 Antigravity를 비교할 때에는 제품 이름과 계정의 접근 정책을 구분한다. 이 책은 Antigravity 공식 시작 문서를 안내하지만 두 제품 사이의 이용권 이전 날짜와 기존 이용자의 현재 권한을 확정 안내하지 않는다. 과거 소개나 설치 경험만으로 지금도 같은 계정이 같은 기능을 쓸 수 있다고 가정하지 않는다. 접근 조건이 선택을 좌우한다면 현재 계정에 적용되는 공식 안내를 먼저 확인한다.

실무에서는 제품명 변경과 계정의 이용권 변경을 구분해야 한다. 설치한 명령 이름이 남아 있어도 서버 정책이 바뀔 수 있고, 문서의 설명이 내 조직 플랜에 해당하지 않을 수 있다. 독자는 자신의 계정에서 공식 안내와 관리 정책을 확인하고 이력표에 출처를 남긴다. 제품을 옮길 때는 작은 더미 저장소로 파일 변경·검사·로그 회수를 다시 시험한다.

직접 해 보기

두 도구를 골라 동일한 다섯 질문으로 조사표를 만든다. 비대화형 실행을 확인했다면 실제 명령을 무작정 실행하지 말고 입력·출력·실행 경로를 먼저 적는다. 계정이 없으면 문서 조사까지만 했다고 표시한다.

해설과 확인 기준

좋은 조사표는 지원이라고만 쓰지 않고 문서의 대상이 CLI인지 웹 제품인지 밝힌다. 기능을 시험하지 못했다면 문서 확인과 실행 확인을 분리한다. 두 후보의 미확인 칸 수를 성능 점수로 바꾸는 것은 잘못이다. 필수 조건이 무엇인지가 먼저다.

근거와 기준일

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

• Codex 프로젝트 지침
• Claude Code 프로젝트 지침
• Cursor 프로젝트 규칙
• GitHub Copilot 저장소 지침
• Antigravity 시작 문서