Claude·Gemini·Codex 실전 백서 - 터미널 AI 코딩 도구를 일에 쓰는 법

세 도구가 공유하는 구조(모델·도구 호출·권한 확인·작업 폴더·지침 파일), 채팅형 도우미와 에이전트형 도구의 차이, 한 번의 요청이 파일 읽기·명령 실행·편집으로 이어지는 흐름, 완성 코드는 가짜 모델과 도구 세 개(읽기·쓰기·명령)로 한 바퀴를 돌리고 각 단계를 기록하는 모형

세 도구의 설치 방식과 인증 방식 비교표(Google 쪽은 2026-06 Gemini CLI → Antigravity CLI 이전과 어느 계정이 어느 도구를 쓰는지 표로)(구독 계정 로그인과 API 키의 차이를 원리로), 처음 켰을 때 확인할 것(작업 폴더·권한 질문), 첫 요청으로 저장소 요약 시키기, 완성 코드는 저장소 폴더를 훑어 언어·파일 수·테스트 폴더·지침 파일 존재 여부를 요약하는 '첫 질문' 흉내 프로그램

지침 파일이 하는 일(매 세션 처음 읽히는 규칙), 들어갈 것(빌드·테스트 명령, 금지 사항, 폴더 구조, 코드 관례)과 빼야 할 것(비밀값·자주 바뀌는 사실), 한 저장소에서 세 파일을 함께 관리하는 방법(공통 내용 하나로 모으기), 폴더별 지침, 완성 코드는 공통 규칙 파일과 도구별 덧붙임을 합쳐 세 지침 파일을 만들고 금지 패턴(키·비밀번호)을 검사하는 생성기

Claude Code 의 --permission-mode·허용/차단 도구 목록, Codex 의 --sandbox 와 --ask-for-approval, 위험도별 명령 분류(읽기·편집·네트워크·삭제·배포), 모두 자동 승인의 위험, 완성 코드는 허용·차단 규칙 목록과 명령 문자열을 받아 허용·질문·거부를 판정하고 판정 이유를 출력하는 권한 규칙 판정기

plan 모드로 먼저 계획 받기, -c/-r 로 세션 이어가기, 하위 에이전트로 조사 맡기기, 훅으로 편집 후 검사 자동 실행, MCP 연결, 실전 작업 한 건의 흐름(조사→계획→구현→검증→커밋), 완성 코드는 '편집 후 훅' 을 흉내 내 파일이 바뀌면 문법 검사(py_compile)를 돌리고 결과를 남기는 감시기

2026-06 이전 배경과 계정·도구 대응표, agy 의 --mode(accept-edits·auto·plan)와 --sandbox, -p 와 json 출력, --conversation 으로 이어가기, MCP·플러그인, 표준 입력을 읽지 않는 헤드리스 함정과 크레딧 소진 대처, 기업·API 키 사용자에게 남은 Gemini CLI 의 GEMINI.md·settings.json, 완성 코드는 계정 종류(개인 무료·AI Pro·기업·API 키)를 받아 쓸 도구와 설정 체크리스트를 출력하는 선택 도우미

codex exec 로 비대화형 실행, 샌드박스 세 단계의 차이, -o 로 마지막 답 받기와 --output-schema, review 하위 명령으로 변경 검토, resume 으로 이어가기, 표준 입력을 닫지 않아 멈추는 함정, 완성 코드는 샌드박스 단계별로 허용되는 동작(파일 읽기·작업 폴더 쓰기·밖 쓰기·네트워크)을 판정하는 표 생성기

세 도구의 비대화형 실행 비교표(-p, exec), JSON·스트림 출력 해석, 시간 제한·재시도·빈 결과 감지(정상 종료인데 결과가 비는 경우), 동시 실행 수 제한, CI 에서 쓸 때 권한을 최소로, 완성 코드는 미리 저장한 JSON 줄 단위 이벤트 기록을 읽어 마지막 답·오류·소요 시간을 뽑고 빈 결과를 실패로 판정하는 해석기

MCP 의 역할(도구·자료를 표준 방식으로 연결), 서버·클라이언트·도구 목록·호출의 흐름, 세 도구(Claude Code·Codex CLI·Antigravity CLI/Gemini CLI)의 설정 위치 비교, 믿을 수 없는 서버의 위험(프롬프트 인젝션·권한), 완성 코드는 JSON 메시지로 도구 목록 요청과 호출을 주고받는 아주 작은 가짜 MCP 서버·클라이언트(같은 프로세스 안)

맥락 창이 차면 생기는 일(앞 내용 잊기·압축), 새 세션을 여는 시점, 큰 파일 통째로 넣지 않기, 작업을 쪼개 요청 수 줄이기, 사용량 한도에 걸렸을 때의 대처(원리로, 수치 없이), 완성 코드는 대화 기록의 글자 수를 낱말 기준으로 어림하고 한도를 넘기 전 요약 대상 구간을 고르는 맥락 예산 계산기

한 도구가 쓰고 다른 도구가 검토하는 분담, 같은 폴더에서 동시에 돌릴 때의 충돌, git worktree 로 작업 폴더 나누기, 작업 지시서와 결과 보고 형식 통일, 사람이 마지막에 확인할 것, 완성 코드는 작업 목록을 받아 작성 도구·검토 도구·worktree 이름을 배정하고 같은 파일을 건드리는 작업끼리 충돌을 경고하는 분배표 생성기

도입 전 정할 것(허용 도구·권한 기본값·비밀값 관리·로그 보관), 지침 파일 검토 절차, AI 가 만든 PR 검토 기준, 효과 측정을 숫자 부풀리기 없이 하는 법(되돌린 변경 비율·검토 지적 수 같은 팀 내부 지표), 완성 코드는 저장소 설정 항목을 점검해 통과·경고·실패 체크리스트와 고칠 방향을 출력하는 도입 점검기