터미널 AI 코딩 CLI 3종 비교 2026 — 클로드 코드·코덱스·제미나이 CLI, 무료로 어디까지 되나

터미널에서 도는 AI 코딩 도구를 깔아 보려다가, 소개 페이지마다 "무료로 시작하세요"만 적혀 있어서 정작 어디서 막히는지는 못 찾고 닫으신 적 있으시죠. 셋 다 깔아 놓고 번갈아 쓰면 좋겠지만, 그 전에 알아야 할 게 있어요.

결론부터 말하면 세 도구가 말하는 "무료"는 서로 다른 뜻이고, 막히는 자리도 서로 달라요. 클로드 코드는 무료 플랜에 접근 자체가 없다고 공식 문서가 못 박고, 코덱스 CLI는 무료 플랜에도 포함되지만 그 한도 숫자가 요금 표에 없으며, 제미나이 CLI는 개인 구글 계정으로 들어가는 무료 경로가 2026년 6월 18일에 닫혔어요. 이 글은 세 도구의 공식 요금 페이지와 문서를 직접 열어 그 조항만 뽑았어요.

세 도구의 "무료"는 서로 다른 뜻이에요

같은 낱말이라 같은 뜻일 것 같지만, 문서를 열어 보면 층위가 다릅니다.

클로드 코드 쪽은 가장 명확해요. 공식 설치 문서의 인증 항목 첫 문장이 "Claude Code requires a Pro, Max, Team, Enterprise, or Console account. The free Claude.ai plan does not include Claude Code access."라고 적어요. 무료 플랜 사용자는 한도가 적은 게 아니라 접근 경로가 없다는 뜻이에요. 같은 문서가 곧바로 대안을 붙이는데, 아마존 베드록이나 구글 클라우드의 에이전트 플랫폼, 마이크로소프트 파운드리 같은 외부 API 제공자를 쓸 수 있다고 안내해요. 전부 종량 과금 경로예요.

코덱스 CLI는 결이 달라요. 오픈AI 고객센터가 "Codex is included across ChatGPT plans, including Free and Go. Usage limits vary by plan."이라고 적어요. 무료 챗GPT 계정으로도 로그인은 된다는 뜻이에요. 그런데 여기서 한 걸음 더 들어가면 이야기가 애매해집니다. 공식 요금 페이지의 사용 한도 표를 열면 탭이 Plus, Pro 5x, Pro 20x, Business, API Key 다섯 개뿐이고 Free 탭이 없어요. 같은 페이지 아래쪽의 기능 가용성 매트릭스도 plus, pro, business, enterprise, api 다섯 갈래로만 짜여 있고요. 쓸 수 있다는 안내는 있는데 얼마나 쓸 수 있는지는 공개된 표에 없는 상태예요.

제미나이 CLI는 세 번째 유형이에요. 저장소 README는 지금도 "Free tier: 60 requests/min and 1,000 requests/day with personal Google account"라고 현재형으로 적고 있어요. 그런데 구글이 운영하는 Gemini Code Assist 소비자 계정 안내는 다른 말을 합니다. 자세한 건 아래에서 따로 볼게요.

무료 진입 경로 비교표, 어디서 막히나

표에서 앞의 네 열은 각 도구의 공식 요금 페이지, 공식 문서 사이트, 공식 고객센터에 적힌 문장을 옮긴 것이에요. 마지막 열은 다릅니다. 이 글은 세 도구를 같은 과제로 돌려 결과를 재 본 글이 아니라서, 코드 품질이나 속도에 대해서는 어느 칸도 채우지 않았어요. 그 비교가 필요하시면 직접 같은 저장소에서 같은 작업을 시켜 보시는 편이 정확해요.

가운데 두 열이 이 글의 핵심이에요. 세 도구 모두 "얼마까지 쓸 수 있는가"를 숫자로 확인하기 어려운 상태인데, 어려운 이유가 각각 다릅니다. 클로드 코드는 무료 진입이 아예 없어서 해당 사항이 없고, 코덱스는 무료 플랜의 숫자를 공개하지 않았으며, 제미나이 CLI는 문서 사이에 서로 어긋나는 숫자가 남아 있어요.

제미나이 CLI의 개인 무료 로그인은 2026년 6월 18일에 닫혔어요

이 항목이 이 글에서 가장 중요해요. 검색으로 나오는 대부분의 안내가 아직 옛 상태를 적고 있거든요.

구글의 Gemini Code Assist 소비자 계정 안내는 이렇게 적어요. "Starting June 18, 2026, Gemini Code Assist IDE extensions stopped serving requests for the Gemini Code Assist for individuals, Google AI Pro, and Google AI Ultra tiers. This also applies to usage of Gemini CLI." 그리고 바로 다음 문장이 "As part of the deprecation, you can no longer use the Login with Google option to access the IDE extensions or Gemini CLI."예요. 이 문서의 갱신일은 2026년 6월 23일이에요.

같은 내용을 구글 개발자 블로그가 먼저 예고했어요. 2026년 5월 19일 자 발표문의 소비자 타임라인 항목이 "On June 18, 2026, Gemini CLI and Gemini Code Assist IDE extensions will stop serving requests for Google AI Pro and Ultra, as well as those using it free of charge using Gemini Code Assist for individuals."라고 적고, 같은 절에서 "Starting today, Antigravity CLI is available to everyone."이라고 후속 도구를 안내해요.

그런데 제미나이 CLI의 저장소와 문서 사이트는 아직 옛 숫자를 그대로 두고 있어요. README는 개인 구글 계정 무료 티어를 현재형으로 적고, 공식 할당량 페이지의 표도 "Google account · Gemini Code Assist (Individual) · 1,000 requests"를 그대로 싣고 있어요. 그 페이지의 갱신일이 2026년 6월 18일인데도요. 재미있는 건 같은 문서 사이트 상단에 배너가 떠 있다는 점이에요. "Unpaid tier and Google One users: Gemini CLI will be replaced by Antigravity CLI on June 18th."라고 적혀 있어요. 배너는 바뀌었는데 본문 표는 그대로 남은 상태라, 표만 보고 판단하면 어긋나요.

여기서 도구를 고를 때 쓸 수 있는 원칙이 하나 나와요. 쓸 수 있는지 없는지는 도구를 만든 쪽이 아니라 접근 권한을 정하는 쪽이 결정해요. 이번 경우에는 CLI 저장소가 아니라 구글의 Code Assist 계정 안내가 그 자리에 있었어요.

그럼 제미나이 CLI가 완전히 죽었느냐 하면 그건 아니에요. 같은 발표문의 기업 고객 항목이 "If your organization uses Gemini CLI or our IDE extensions via a Gemini Code Assist Standard or Enterprise license ... your access remains unchanged."라고 적고, 이어서 "Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys."라고 밝혀요. Code Assist 안내의 FAQ도 Standard와 Enterprise 구독은 영향이 없다고 답해요. 정리하면 닫힌 것은 개인 계정으로 들어가는 무료 문이고, 유료 라이선스와 유료 API 키 경로는 남아 있어요.

API 키 쪽은 숫자가 문서마다 달라서 주의가 필요해요. README는 "1000 requests/day with Gemini 3 (mix of flash and pro)"라고 적는데, 같은 프로젝트의 공식 할당량 페이지는 무료 API 키에 대해 "250 maximum model requests / user / day"와 "Model requests to Flash model only."라고 적어요. 한편 구글 발표문은 남는 경로를 "paid" API 키로 한정해 표현하고요. 세 문장이 한 방향을 가리키지 않아서, 이 글에서는 어느 숫자도 확정된 값으로 옮기지 않을게요.

이동 대상인 도구가 궁금하시면 Antigravity의 병렬 에이전트 구조와 실제 적용 패턴을 먼저 보시면 감이 잡혀요. 구글 계정 요금제 자체를 정리하고 싶다면 제미나이 요금제 무료·프로·울트라 차이가 같이 보기 좋고요.

옮길 때 손이 가는 부분도 미리 알아 두면 편해요. Antigravity 공식 마이그레이션 가이드는 agy 명령을 처음 실행하면 기존 설정을 자동으로 감지한다고 적고, GEMINI.md와 AGENTS.md 규칙 문서는 그대로 읽힌다고 밝혀요. 반면 경고 블록 하나가 붙어 있어요. 프로젝트 안의 .gemini/skills/ 폴더는 자동으로 옮겨지지 않으니 .agents/skills/로 직접 이름을 바꾸거나 옮겨야 슬래시 명령으로 인식된다는 내용이에요. MCP 서버 설정도 파일 위치가 바뀌었고, 원격 서버를 적을 때 쓰던 url이나 httpUrl 키는 serverUrl로 이름이 바뀌었어요.

클로드 코드는 무료 경로 자체가 없어요

앞에서 본 문장을 다시 짚을게요. 공식 설치 문서가 Pro, Max, Team, Enterprise, Console 계정 중 하나가 필요하고 무료 Claude.ai 플랜에는 접근이 포함되지 않는다고 적어요. 공식 문서의 플랜별 기능 비교표도 열이 Pro, Max, Team, Enterprise 넷뿐이고 Free 열이 없어요.

그래서 클로드 코드에서 궁금해할 지점은 "무료로 되나"가 아니라 "구독 한도가 어떻게 걸리나"로 옮겨갑니다. 앤트로픽 고객센터는 "Both Pro and Max plans offer usage limits that are shared across Claude and Claude Code, meaning all activity in both tools counts against the same usage limits."라고 적어요. 웹에서 클로드로 문서를 정리한 만큼 터미널 몫이 줄어든다는 뜻이에요. 같은 문서가 IDE 사용분도 같은 한도를 쓴다고 덧붙여요.

한도에 닿았을 때 어떤 메시지가 뜨는지도 문서에 있어요. 비용 관리 문서는 "You've hit your session limit" 또는 "You've hit your weekly limit"이 뜨면 좌석 기반 사용 창에 걸린 것이고, 이 창은 모든 모델에 공유되므로 모델을 바꿔도 접근이 돌아오지 않는다고 적어요. 반대로 컨텍스트나 자동 압축 경고는 한도가 아니라고 같은 문서가 구분해 줘요. 대화가 길어져서 오래된 내용을 요약할 시점이 됐다는 신호일 뿐이에요. 팀과 엔터프라이즈 플랜에 대해서는 "a rolling five-hour window and a weekly window"라고 창의 단위까지 적혀 있는데, 개인 플랜의 구체적인 요청 수는 공개돼 있지 않아요.

여기서 한 번쯤 발등을 찍는 함정이 하나 있어요. 고객센터가 굵은 글씨로 경고하는 내용인데, 시스템에 ANTHROPIC_API_KEY 환경변수가 설정돼 있으면 클로드 코드가 구독 대신 그 API 키로 인증해서 구독에 포함된 사용량이 아니라 API 요금이 청구된다는 거예요. 공식 설치 문서도 같은 동작을 적으면서, 이 경우 브라우저를 열지 않고 키를 승인할지 한 번 묻는다고 안내해요. 예전에 API로 실험해 본 적이 있는 컴퓨터라면 설치 전에 환경변수를 한 번 확인해 보세요. 설치와 첫 세션 흐름 자체가 처음이시면 클로드 코드 설치부터 실전 워크플로까지를 같이 보시면 순서가 이어져요.

코덱스 CLI는 무료 플랜에도 포함되지만 그 한도는 공개돼 있지 않아요

코덱스 CLI의 무료 진입은 문서로 확인돼요. 오픈AI 고객센터가 무료와 Go를 포함해 모든 챗GPT 플랜에 코덱스가 포함되고 한도만 플랜별로 다르다고 적어요. 저장소 README도 codex를 실행한 뒤 "Sign in with ChatGPT"를 고르라고 안내하고요.

문제는 그다음이에요. 요금 페이지의 한도 표에 Free 탭이 없어서, 무료 플랜의 숫자는 확인되지 않아요. 비교 삼아 Plus 탭의 값을 보면 폭이 얼마나 넓은지 감이 옵니다. 로컬 메시지 기준으로 GPT-5.6 Sol이 5시간당 10~100회, Terra가 25~200회, Luna가 250~2,000회예요. 같은 모델군 안에서도 자릿수가 달라지는 셈이에요. 표 각주는 로컬 메시지와 클라우드 채팅이 5시간 창을 공유하고 주간 한도가 더 붙을 수 있다고 적어요.

왜 이렇게 범위로만 적히는지도 같은 페이지가 설명해요. "Tasks that look similar can consume different amounts of your allowance. Model choice, context, reasoning, tool use, retrieval, and caching all affect usage, so prompt length alone isn't a reliable estimate."라고 적어요. 프롬프트 길이로 소모량을 가늠할 수 없다는 뜻이에요. 고객센터도 코덱스와 다른 제품들이 같은 사용량 풀에서 빠져나간다고 밝히고 있어요.

그래서 무료나 저가 플랜으로 버티려면 세션 안에서 남은 양을 직접 보는 습관이 필요해요. 요금 페이지가 "If you want to see your remaining limits during an active Codex CLI session, you can use /status."라고 명령까지 적어 두었어요. 한도를 아끼는 방법도 같은 페이지에 있는데, 그중 실무에서 체감이 큰 항목이 MCP 서버 정리예요. 서버를 하나 붙일 때마다 메시지에 맥락이 더 실려서 한도를 더 쓰게 되니, 안 쓰는 서버는 꺼 두라고 권해요. 무료 플랜에서 빠지는 기능도 문서에 한 줄 있어요. 이미지 생성은 Free 플랜에서 쓸 수 없다고 적혀 있어요.

윈도우 사용자라면 설치 단계에서 한 번 걸릴 수 있어요. 저장소의 docs/install.md 시스템 요건 표는 운영체제를 "macOS 12+, Ubuntu 20.04+/Debian 10+, or Windows 11 via WSL2"라고 적는데, 같은 저장소 README와 공식 CLI 문서는 윈도우용 파워셸 설치 명령을 별도로 제시해요. 같은 프로젝트 안에서 문서끼리 어긋나 있는 상태라, 네이티브 설치를 먼저 시도하고 안 되면 WSL2를 후보로 두는 순서가 현실적이에요. 코덱스로 터미널 밖 작업까지 맡겨 본 기록은 코덱스 윈도우 컴퓨터 유즈 첫 주 사용기에 정리해 두었어요.

설치 전에 먼저 걸리는 자리, 운영체제와 런타임

한도보다 먼저 걸리는 게 사양인 경우가 의외로 많아요. 세 도구의 공식 요건을 나란히 놓으면 이래요.

클로드 코드. 공식 시스템 요건이 macOS 13.0 이상, Windows 10 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상을 적어요. 하드웨어는 4GB 이상 램과 x64 또는 ARM64 프로세서, 셸은 Bash와 Zsh, PowerShell, CMD를 받아요. 지역 조건도 있는데, 앤트로픽 지원 국가 목록을 가리키고 그 목록에 대한민국이 들어 있어요. 설치 방식은 macOS와 리눅스가 curl 스크립트, 윈도우가 파워셸 스크립트나 WinGet이 권장이고, README가 npm 설치는 더 이상 권장하지 않는다고 명시해요.

코덱스 CLI. 저장소 문서 기준으로 macOS 12 이상, Ubuntu 20.04 이상이나 Debian 10 이상, 윈도우는 앞서 적은 대로 문서가 엇갈려요. 램은 최소 4GB이고 8GB를 권장해요. Git은 선택이지만 2.23 이상이면 내장 PR 보조 기능을 쓸 수 있다고 적혀 있어요.

제미나이 CLI. 권장 사양이 macOS 15 이상, Windows 11 24H2 이상, Ubuntu 20.04 이상이에요. 램은 짧은 세션이면 4GB 이상, 긴 세션과 큰 저장소를 다루면 16GB 이상을 권해요. 런타임은 Node.js 20.0.0 이상, 셸은 Bash와 Zsh, PowerShell이에요. 세 도구 중 운영체제 요구가 가장 높은 편이라, 오래된 맥이나 윈도우 10 기기라면 여기서 먼저 걸려요.

정리하면 운영체제별로 문턱이 갈려요. 윈도우 쪽은 클로드 코드만 윈도우 10을 명시하고 나머지 둘은 윈도우 11을 적어요. 맥 쪽은 반대라서 코덱스가 macOS 12로 가장 낮고 제미나이 계열이 macOS 15로 가장 높아요. 오래된 윈도우 노트북이라면 선택지가 클로드 코드로 좁혀지는데, 하필 그 도구가 무료 진입이 없는 쪽이에요. 사양과 지갑이 서로 다른 방향으로 걸리는 셈이라, 기기부터 확인하고 요금을 보는 순서가 시간을 아껴요.

무료로 쓸 때 내 코드는 어디로 가나

무료 경로를 고를 때 요금만 보면 놓치는 항목이에요. 세 곳 모두 공식 문서에 적어 두었어요.

앤트로픽의 데이터 사용 문서는 무료와 Pro, Max 계정에 대해 설정이 켜져 있으면 그 계정 데이터로 새 모델을 학습하며 클로드 코드 사용분도 여기 포함된다고 적어요. 반대로 팀과 엔터프라이즈, API 같은 상업 계정에 대해서는 코드나 프롬프트를 모델 학습에 쓰지 않는다고 밝히고요. 보관 기간도 여기 연동돼서, 학습을 허용하면 5년이고 허용하지 않으면 30일이에요. 개인 계정과 회사 계정의 기본값이 반대 방향인 셈이라, 회사 코드를 다루는 자리라면 어느 계정으로 로그인했는지가 곧 정책이 돼요.

오픈AI 고객센터는 Pro와 Plus에 대해 데이터 컨트롤에서 학습을 끄지 않으면 대화가 모델 개선에 쓰일 수 있다고 적고, 비즈니스와 엔터프라이즈, API 같은 업무용 계정은 기본적으로 학습에 쓰지 않는다고 밝혀요. 여기서도 방향이 같아요. 개인 요금제는 켜져 있는 게 기본이고, 업무용은 꺼져 있는 게 기본이에요.

구글 쪽은 제미나이 CLI 문서 사이트의 요금 카드에 한 줄이 있어요. AI Studio 항목에 "Free tier data may be used to improve products"라고 적혀 있고, 같은 카드가 종량 과금으로 올리면 프라이버시와 더 높은 한도를 얻는다고 안내해요. 후속 도구인 Antigravity CLI는 저장소 README에서 더 직접적으로 적어요. 사용하면 상호작용 데이터 수집과 활용에 동의하는 것이며 설정에서 언제든 해제할 수 있다는 내용이에요. 같은 문서에 경고 블록도 붙어 있는데, AI 코딩 에이전트에는 자율 코드 실행과 데이터 유출, 프롬프트 주입, 공급망 위험이 알려져 있으니 에이전트의 모든 동작을 확인하라는 내용이에요. 만든 쪽이 스스로 적어 둔 문장이라 한 번은 읽어 볼 값이 있어요.

뭘 먼저 깔지 정하는 5문항 자가진단

도구를 고르기 전에 아래 다섯 문항에서 "그렇다"가 몇 개인지 세어 보세요.

1. 클로드 Pro나 Max, 또는 챗GPT Plus 이상을 이미 매달 결제하고 있다.
2. 회사 코드나 고객 데이터가 들어 있는 저장소에서 쓸 계획이다.
3. 하루에 한두 시간 이상, 여러 파일을 고치는 작업에 쓸 생각이다.
4. 쓰는 기기가 최신 운영체제이고 램이 16GB 이상이다.
5. 이미 GEMINI.md나 AGENTS.md 같은 규칙 파일을 만들어 쓰고 있다.

1번이 "그렇다"면 새로 결제할 것 없이 그 구독에 붙는 도구부터 켜 보는 게 순서예요. 클로드 구독이면 클로드 코드, 챗GPT 구독이면 코덱스 CLI가 같은 계정으로 바로 붙어요.

2번이 "그렇다"면 개인 요금제로 시작하지 마세요. 앞에서 본 대로 세 곳 모두 개인 계정과 업무용 계정의 학습 기본값이 반대예요. 팀이나 비즈니스 계정을 먼저 확보한 다음에 붙이는 편이 나중에 되돌릴 일이 없어요.

3번이 "그렇다"면 무료 경로만으로 버티기는 어려워요. 세 도구 다 한 번의 지시가 요청 여러 건으로 쪼개지는 구조거든요. 구글 클라우드의 할당량 문서가 "one prompt might result in multiple model requests"라고 적고, 하루 한도가 모델 종류를 가리지 않고 합산되며 한 번 소진되면 어떤 모델로도 요청을 보낼 수 없다고 밝혀요. 오픈AI 요금 페이지도 같은 취지로 프롬프트 길이만으로는 소모량을 추정할 수 없다고 적고요.

4번이 "아니다"면 제미나이 계열은 나중 차례로 미루세요. 권장 사양이 셋 중 가장 높아요.

5번이 "그렇다"면 이동 비용을 미리 계산해 두세요. 규칙 파일 자체는 그대로 읽히지만, 앞서 본 대로 워크스페이스 스킬 폴더와 MCP 설정은 손으로 옮겨야 해요.

이 다섯 문항의 컷은 공식 문서가 정해 준 기준이 아니라 제가 나눠 본 참고선이에요. 다만 각 문항이 근거 없이 나온 건 아니고, 전부 위에서 인용한 공식 문서의 조항에서 뽑았어요.

이 글에서 확인하지 못한 것

솔직하게 남겨 둘게요. 이 글이 답하지 못한 게 세 가지 있어요.

첫째, 코덱스 무료 플랜과 Go 플랜의 구체적인 한도 숫자예요. 공식 요금 페이지의 한도 표가 Plus부터 시작하고, 기능 매트릭스에도 무료 열이 없어요. 고객센터가 "플랜마다 다르다"고만 적고요.

둘째, 제미나이 CLI 후속인 Antigravity 무료 등급의 주간 한도예요. 공식 요금 페이지의 개인 무료 카드가 "Basic weekly rate limits"라고 적고 별표만 달아 두었을 뿐 숫자가 없어요. 대신 세션 안에서 /usage 또는 /quota 명령으로 남은 양을 볼 수 있다고 문서가 안내해요.

셋째, 클로드 코드 개인 플랜의 5시간 창에 담긴 요청 수예요. 문서는 창이 있다는 것과 한도에 닿았을 때 뜨는 메시지까지만 적고 숫자를 공개하지 않아요.

여기에 하나 더 붙이면, 이 글은 세 도구의 코드 품질이나 속도를 재지 않았어요. 공식 문서에 적힌 요건과 한도, 데이터 정책만 대조한 글이에요. 그리고 여기 옮긴 조항은 전부 문서가 갱신되면 바뀔 수 있어요. 제미나이 CLI 사례처럼 저장소와 문서가 같은 시점에 서로 다른 말을 하고 있을 수도 있으니, 결제나 도입을 앞두고 있다면 해당 페이지를 그 자리에서 다시 여는 습관이 필요해요.

마무리, 오늘 해볼 한 가지

설치 파일을 내려받기 전에 5분만 쓰세요. 지금 쓰는 계정 상태를 확인하는 거예요.

먼저 매달 결제 중인 AI 구독이 있는지 보세요. 있으면 그 계정에 붙는 CLI가 오늘의 답이에요. 없으면 다음 질문으로 넘어가요. 회사 코드에서 쓸 건지, 개인 프로젝트에서 쓸 건지예요. 회사 코드라면 개인 요금제로 시작하지 말고 조직 계정부터 알아보세요. 개인 프로젝트라면 무료 진입이 되는 쪽부터 짧게 시험해 보고, 세션 안에서 남은 양을 보는 명령을 먼저 익혀 두세요.

마지막으로 하나만 더 짚을게요. 예전에 API로 실험해 본 적이 있는 컴퓨터라면 환경변수부터 확인하세요. 앞에서 본 대로 키가 남아 있으면 구독 대신 종량 과금으로 붙어서, 쓰는 사람은 구독을 쓴다고 생각하는데 청구서는 따로 쌓여요. 터미널에 한 줄 쳐서 확인하는 데 몇 초면 충분한 일이에요.