Gemini CLI

Gemini CLI는 구글이 만든 오픈소스 터미널 AI 에이전트입니다. 검은 명령 줄 화면에서 구글의 제미나이(Gemini) 모델에게 곧바로 일을 시키는 도구입니다. "이 버그 고쳐줘", "테스트 커버리지 늘려줘", "이 기능 새로 만들어줘"라고 말하면, 코드를 읽고 파일을 고치고 명령을 실행해 작업을 끝까지 처리합니다. 2025년 6월에 공개됐고, 라이선스는 누구나 가져다 쓰고 고칠 수 있는 아파치 2.0입니다.

가장 큰 특징은 무료 한도가 넉넉하다는 점입니다. 개인 구글 계정으로 로그인만 하면 분당 60회, 하루 1,000회까지 요청을 무료로 보낼 수 있습니다. 이 한도 안에서 제미나이 3 모델과 100만 토큰짜리 긴 컨텍스트 윈도우(context window)를 그대로 씁니다. 유료 AI 코딩 도구가 부담스러운 학생이나 개인 개발자가 진입하기 좋은 이유입니다. 큰돈 들이지 않고 에이전트 코딩이 어떤 건지 직접 만져볼 수 있습니다.

비유하면 터미널 안에 상주하는 코딩 조수입니다. 자판기처럼 동전을 넣어야 움직이는 게 아니라, 매일 일정량은 그냥 부려도 되는 조수가 옆에 앉아 있는 셈입니다. 깃허브 별 10만 개를 넘길 만큼 개발자들이 빠르게 모였고, 업데이트도 자주 나옵니다.

이 도구를 이해하려면 같은 부류와 묶어 보는 게 빠릅니다. 클로드 코드(Claude Code), OpenAI의 코덱스(Codex)와 함께 명령 줄 인터페이스(CLI)에서 도는 에이전틱 AI 코딩 도구 카테고리에 속합니다. 셋의 차이는 뒤에 붙은 모델 회사입니다. Gemini CLI는 구글 제미나이, 클로드 코드는 앤트로픽, 코덱스는 OpenAI 모델을 씁니다. Gemini CLI는 추론과 행동을 번갈아 하는 ReAct 방식으로 돌아가고, 구글 검색 연동, 파일 조작, 셸 명령 실행, 웹 페이지 가져오기 같은 도구를 기본 내장합니다.

실제로 어떻게 쓰는지 그려보면 이렇습니다. 새 프로젝트 폴더를 열고 터미널에서 Gemini CLI를 켭니다. "이 코드의 테스트가 부족하다, 빠진 케이스를 찾아 테스트를 추가해줘"라고 말하면, 도구가 코드를 훑어 읽고 어떤 부분에 테스트가 없는지 짚습니다. 그다음 테스트 파일을 새로 만들고 실행해 통과하는지 확인합니다. 막히는 부분이 있으면 구글 검색으로 관련 정보를 가져와 참고하기도 합니다. 개발자는 코드를 한 줄씩 치는 대신, 방향을 정하고 결과를 확인하는 역할을 맡습니다. 버그 수정, 새 기능 추가, 테스트 보강 같은 작업을 통째로 위임할 수 있습니다.

내장된 구글 검색 연동은 특히 쓸모가 있습니다. 모델이 학습 시점 이후의 최신 정보를 모를 때, 검색으로 실시간 정보를 끌어와 답에 반영합니다. 라이브러리의 최신 사용법이나 막 바뀐 API 문법을 물어볼 때 옛 정보로 엉뚱하게 답하는 일이 줄어듭니다. 모델 혼자가 아니라 검색이라는 외부 도구를 손에 쥔 에이전트라서 가능한 일입니다.

설치는 간단합니다. Node.js가 깔려 있으면 한 줄로 끝납니다.

설치 후 터미널에서 gemini를 입력하고 구글 계정으로 로그인하면 바로 무료 한도 안에서 쓸 수 있습니다. 더 큰 한도나 업무용 보안이 필요하면 구글 클라우드의 코드 어시스트(Code Assist) 라이선스나 API 키 방식으로 올라갈 수 있습니다. 오픈소스(open-source)라서 소스를 직접 들여다보고 고치거나, 회사 환경에 맞춰 포크해 쓰는 것도 가능합니다.

오픈소스라는 점은 단순히 공짜라는 의미를 넘어섭니다. 코드가 모두 공개돼 있어서, 이 도구가 내 컴퓨터에서 정확히 무슨 명령을 실행하는지 직접 확인할 수 있습니다. 보안에 민감한 회사라면 이 점이 결정적입니다. 어떤 파일을 읽고 어떤 서버로 데이터를 보내는지 코드 수준에서 검증하고 나서 도입할 수 있기 때문입니다. 전 세계 개발자가 함께 들여다보며 버그를 잡고 기능을 더하는 구조라, 업데이트 속도도 빠른 편입니다.

무료로 시작해 필요할 때만 유료로 올라가는 구조라, AI 코딩 도구를 처음 써보는 입장에서 부담이 적습니다. 일단 개인 계정으로 켜서 며칠 써보고, 손에 익으면 그때 유료 한도나 업무용 환경을 고민해도 늦지 않습니다.