호환 에이전트

Gemini CLI 활용: 터미널에서 SaaS 출시가 가능할까?

Gemini CLI는 무료 일일 할당량, 내장 브라우저 에이전트, 완전한 MCP 지원을 터미널로 가져옵니다. 출시 작업에 활용할 수 있는 범위가 꽤 넓습니다. 아래에서는 디렉터리 출시 중 Gemini CLI가 혼자 처리하는 부분과, 나와 LaunchRepo가 나서는 부분을 정리합니다.

마케팅 분야의 Gemini CLI 활용이라고 하면 보통 터미널에서 문구 초안, 리서치, 콘텐츠를 만드는 일을 뜻합니다. 여기서는 배포를 뜻합니다. 내 계정으로 SaaS를 디렉터리와 출시 플랫폼에 하나씩 등록하는 일입니다. 아래의 Gemini CLI 관련 사실은 모두 문서나 저장소로 연결되고 확인한 날짜를 함께 적었으며, 사람이 직접 나서야 하는 부분은 페이지에 그대로 밝혀 두었습니다.

출시에 중요한 Gemini CLI 기능

2026년 9월 29일에 문서와 저장소를 살펴봤습니다. 새 버전이 자주 나오므로, 모든 항목에 출처 페이지 링크를 달았습니다.

개요
Google이 만든 오픈소스 AI 에이전트로, 터미널에서 실행되며 Apache 2.0 라이선스를 따릅니다. 기본 제공 도구로 파일 작업, 셸 명령, 웹 가져오기, Google 검색 그라운딩을 지원합니다.github.com ↗ · 2026년 9월 29일 확인
릴리스 속도
확인 시점의 최신 안정 버전은 2026년 9월 23일에 공개된 v0.61.0이었습니다. 그 사이사이에 프리뷰 빌드와 나이틀리 빌드도 나옵니다.github.com ↗ · 2026년 9월 29일 확인
무료 할당량
개인 Google 계정(개인용 Gemini Code Assist)으로 로그인하면 사용자당 하루 최대 1,000건의 모델 요청을 쓸 수 있습니다. 분당 한도와 서비스 가용성의 제약도 적용되며, 각 요청을 어떤 Gemini 모델이 처리할지는 Gemini CLI가 고릅니다.geminicli.com ↗ · 2026년 9월 29일 확인
컨텍스트 파일
Gemini CLI는 GEMINI.md 파일을 지속적인 지침으로 불러옵니다. 먼저 ~/.gemini에 있는 전역 파일을, 그다음 워크스페이스와 상위 폴더의 파일을 읽습니다. context.fileName 설정으로 다른 파일 이름을 추가할 수 있으며, 문서는 그 예로 AGENTS.md를 듭니다.geminicli.com ↗ · 2026년 9월 29일 확인
MCP 서버
MCP 서버는 settings.json의 mcpServers 객체에 넣거나 gemini mcp add로 추가합니다. 서버를 신뢰함으로 표시하지 않는 한, Gemini CLI는 그 서버의 도구를 실행할 때마다 먼저 묻습니다.geminicli.com ↗ · 2026년 9월 29일 확인
브라우저 에이전트
기본적으로 꺼져 있는 내장 브라우저 에이전트가 접근성 트리를 통해 페이지 이동, 클릭, 양식 입력을 합니다. 번들로 포함된 Chrome DevTools MCP 서버를 사용하며, Chrome 144 이상이 필요합니다.geminicli.com ↗ · 2026년 9월 29일 확인
내 Chrome에 연결하기
‘existing’ 세션 모드에서는 chrome://inspect/#remote-debugging에서 원격 디버깅을 켜면, 브라우저 에이전트가 이미 실행 중인 Chrome에 연결합니다. 양식 입력은 승인 모드와 상관없이 항상 내 확인이 필요합니다.geminicli.com ↗ · 2026년 9월 29일 확인
승인 모드
--approval-mode 플래그에는 default, auto_edit, yolo, plan을 지정할 수 있습니다. yolo는 모든 작업을 자동 승인하며, 예전 --yolo 플래그는 더 이상 권장되지 않습니다.geminicli.com ↗ · 2026년 9월 29일 확인
헤드리스 모드
-p(또는 --prompt)를 쓰거나 TTY가 없는 환경에서는 Gemini CLI가 비대화형으로 실행되며, 일반 텍스트, JSON, JSON 이벤트 스트림으로 결과를 돌려줄 수 있습니다.geminicli.com ↗ · 2026년 9월 29일 확인

Gemini CLI가 멈추고 나를 기다리는 지점

터미널 에이전트가 나 대신 로그인 챌린지를 통과할 수는 없고, 디렉터리는 바로 그렇게 되도록 설계되어 있습니다. 미리 계획해 둘 멈춤 지점은 다음과 같습니다.

양식 입력 확인
내장 브라우저 에이전트는 승인 모드와 상관없이 양식을 채울 때마다 확인을 요청합니다. 제출에는 오히려 장점입니다. 내가 클릭하지 않으면 아무것도 나가지 않습니다.
로그인
Gemini CLI가 연결하는 Chrome에서 디렉터리마다 직접 로그인하세요. Google 팝업과 새 기기 확인은 내 몫이며, 비밀번호는 프롬프트에 절대 넣지 않습니다.
CAPTCHA와 봇 확인
많은 제출 페이지에 Cloudflare, reCAPTCHA, hCaptcha가 나타납니다. 같은 탭에서 직접 풀면 되며, LaunchRepo는 이를 우회하려고 시도하지 않습니다.
메일 코드
확인 링크는 내 메일함으로 옵니다. 연결된 Chrome에서 메일함이 열려 있지 않다면 코드를 직접 전달하세요.
할당량과 ‘게시됨’
까다로운 양식에서 재시도를 반복하면 하루 요청 할당량이 줄어들고, 감사 페이지는 리스팅이 아닙니다. 누군가는 실제 결과와 다음 확인 날짜를 기록해야 합니다.

브라우저 에이전트로 LaunchRepo 사용하기 →

GEMINI.md, 확장 프로그램, 출시를 위한 맥락

마케팅용 Gemini CLI 확장 프로그램과 프롬프트 모음은 대부분 문구, SEO, 소셜 게시물을 다룹니다. 출시 문구에는 유용하지만, 어떤 디렉터리가 아직 무료 제출을 받는지, 양식이 어떤 필드를 거부하는지, 리스팅이 공개됐는지는 말해 주지 않습니다.

settings.json에 추가하는 것은 MCP 서버든 확장 프로그램이든 내 권한으로 실행됩니다. 직접 작성하지 않은 서버는 신뢰함을 꺼 두세요. 그래야 모든 도구 호출이 여전히 먼저 묻습니다.

LaunchRepo도 확장 프로그램이 아닙니다. 저장소에는 AGENTS.md 런북, Markdown 플레이북 299개, 제품 템플릿 하나, 트래커가 들어 있습니다. context.fileName에 AGENTS.md를 추가하면 Gemini CLI가 GEMINI.md처럼 불러옵니다.

Gemini CLI로 LaunchRepo 실행하기

Gemini CLI에는 브라우저 경로가 두 가지 있습니다. ‘existing’ 세션 모드의 내장 브라우저 에이전트, 또는 일반 서버로 추가한 Chrome DevTools MCP입니다. LaunchRepo 가이드는 두 번째 경로를 기준으로 쓰였고, 그래서 설정이 다른 에이전트와 똑같이 유지됩니다. Gemini CLI로 테스트한 실행 결과는 공개하지 않았으며, 이 호환성은 문서와 대조해 확인한 것입니다.

AGENTS.md 불러오기
구매 후 비공개 저장소를 클론하고, 그 폴더에서 gemini를 시작한 뒤 context.fileName에 AGENTS.md를 추가하거나, 그 파일부터 읽으라고 요청하세요.
폴더 신뢰하기
Gemini CLI는 신뢰한 폴더에서만 stdio MCP 서버를 시작하며, 그 밖에서는 Disconnected로 표시됩니다. 클론한 저장소에서 gemini trust를 한 번 실행하세요.
브라우저 서버 추가하기
아래 항목을 ~/.gemini/settings.json에 병합하거나, -s user와 함께 gemini mcp add를 쓰세요. trust는 false로 두세요.
Python 허용하고 규칙 정하기
셸 도구는 내가 승인한 뒤 Python 3.10+ 스크립트를 실행합니다. 그다음 authorizations.json에 Gemini CLI가 제품마다 할 수 있는 일을 기록하며, 지출은 0으로 고정됩니다.

~/.gemini/settings.json에 넣을 mcpServers 블록입니다. LaunchRepo 브라우저 가이드의 서버 정의에 Gemini의 trust 플래그를 더한 것입니다.

~/.gemini/settings.json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ],
      "trust": false
    }
  }
}

geminicli.com 문서에 나온 형식이며, 2026년 9월 30일에 확인했습니다. ↗

gemini mcp list를 실행하거나 세션 안에서 /mcp를 입력하세요. chrome-devtools가 CONNECTED로 보여야 합니다. 그다음 빈 탭에서 example.com을 열어 달라고 요청하고, Chrome의 요청을 허용한 뒤 보이는 탭이 움직였는지 확인하세요.

코딩 에이전트를 내 Chrome에 연결하기 →

이제 START.md의 공개 시작 프롬프트를 한 글자도 바꾸지 말고 붙여 넣으세요. 첫 줄이 Claude Code CLI나 Codex CLI를 권장한다고 망설일 필요는 없습니다. 그것은 저희의 일반적인 기본값일 뿐이고, 이후의 모든 지침은 Gemini CLI에도 그대로 적용됩니다.

START.md — 영어 그대로 붙여 넣으세요
Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

플레이북과 지침은 영어 Markdown입니다. 제품 문구는 디렉터리가 받는 언어라면 무엇이든 괜찮고, 에이전트는 내 언어로 답합니다.

세 단계로 LaunchRepo 시작하기 →
Claude Code로 LaunchRepo 사용하기 →

Gemini CLI 연결이 실패할 때

Gemini CLI와 Chrome DevTools MCP 문서가 권하는 방법을, 대부분의 경우를 해결하는 순서대로 정리했습니다.

chrome-devtools가 Disconnected로 표시됨
gemini mcp list는 신뢰한 폴더에서만 stdio 서버를 시작하고 테스트합니다. 저장소에서 gemini trust를 실행한 뒤 다시 목록을 확인하세요.
서버가 아예 시작되지 않음
같은 터미널에서 npx chrome-devtools-mcp@latest --help를 실행해 Node.js와 npm을 확인하세요. ERR_MODULE_NOT_FOUND는 지원되지 않는 Node 버전이나 손상된 npx 캐시를 가리키며, Chrome DevTools MCP 문제 해결 가이드에 캐시 정리 방법이 나와 있습니다.
배치 도중 할당량이 바닥남
멈추고, 각 플랫폼이 지금 보여 주는 상태를 record.py로 기록한 뒤, 할당량이 초기화되면 이어서 하세요. 실행 상태는 채팅이 아니라 트래커가 보관합니다.

--autoConnect에서 브라우저 도구가 시간 초과되면 네 가지를 확인하세요. Chrome 144 이상이 이미 실행 중인지, chrome://inspect/#remote-debugging에서 원격 디버깅이 켜져 있는지, Chrome의 연결 요청을 허용했는지, 다른 도구가 같은 브라우저를 잡고 있지 않은지입니다. Chrome DevTools MCP는 열린 탭을 모두 불러오므로 필요 없는 탭은 닫아 두세요.

Gemini CLI, LaunchRepo, 나 사이의 출시 분담

출시 작업 다섯 가지, 처리 방식 세 가지입니다.

작업Gemini CLI 단독LaunchRepo와 함께나
출시 문구터미널에서 작성product.json에서 필드마다 가져옴사실 정보 최종 승인
플랫폼 목록Google 검색 그라운딩, 검증 안 됨날짜가 기록된 플레이북 299개 중 선택배치 크기 결정
양식 규칙페이지마다 새로 파악플레이북에서 읽음요청 시 빠진 정보 보충
챌린지내 입력을 기다림사람에게 인계했다고 기록하고 다른 곳 진행같은 탭에서 직접 해결
결과 기록세션이 끝나면 사라짐record.py가 submissions.json에 기록공개 URL 확인

작동 방식 →

흔한 실수

yolo 모드나 헤드리스 모드로 제출하기
자동 승인과 -p는 파일을 읽거나 트래커를 확인할 때는 괜찮습니다. 하지만 제출할 때는 로그인, 챌린지, 양식 입력 확인, Chrome의 요청 때문에 가까이 있어야 합니다.
브라우저 에이전트의 기본 프로필 사용하기
‘persistent’ 모드에서 내장 브라우저 에이전트는 자체 Chrome 프로필을 여는데, 그 프로필에는 내 계정이 하나도 로그인되어 있지 않습니다. 대신 내 Chrome에 연결하세요.
재시도로 하루 할당량 소진하기
무료 등급은 모델 요청 수로 계산되며, 재시도가 많은 긴 양식은 할당량을 금방 써 버립니다. 작은 배치로 작업하고, 계속 실패하는 플랫폼에서는 멈추세요.
브라우저 서버를 신뢰함으로 두기
--trust 플래그는 해당 서버의 확인 요청을 모두 건너뜁니다. 제출 버튼을 누를 수 있는 도구라면 확인 요청을 남겨 두세요.

자주 묻는 질문

Gemini CLI가 브라우저를 조작할 수 있나요?

네. 내장 브라우저 에이전트는 Chrome DevTools MCP를 사용하며 Chrome 144 이상이 필요합니다. Chrome DevTools MCP를 MCP 서버로 직접 추가할 수도 있습니다. 어느 쪽이든 원격 디버깅을 켜면 이미 실행 중인 Chrome에 연결할 수 있습니다.

Gemini CLI는 무료인가요?

도구 자체는 오픈소스입니다. 개인 Google 계정을 쓰면 문서에 나온 무료 할당량은 하루 최대 1,000건의 모델 요청이며, 여기에 분당 한도가 더해집니다. Google 유료 요금제와 API 키에는 각각 별도의 한도가 있습니다.

Gemini CLI가 AGENTS.md를 읽나요?

기본적으로는 GEMINI.md를 찾습니다. 문서의 예시처럼 settings.json의 context.fileName에 AGENTS.md를 포함하거나, 세션을 시작할 때 그 파일을 읽으라고 요청하세요.

Gemini CLI로 내 SaaS 마케팅을 할 수 있나요?

일부는 가능합니다. 문구 초안 작성, 플랫폼 조사, 연결된 브라우저에서 양식 작성을 할 수 있습니다. 하지만 디렉터리 출시에 필요한 플랫폼별 규칙이 없고 세션 사이에 결과 기록도 남기지 않으며, 로그인, CAPTCHA, 2FA는 여전히 내 몫입니다.

Gemini CLI가 CAPTCHA를 풀 수 있나요?

문서 어디에도 그렇다는 내용은 없으며, LaunchRepo도 시도하지 않습니다. 챌린지가 나오면 사람에게 넘기는 인계로 기록합니다. 같은 창에서 직접 푼 뒤 에이전트가 이어서 진행합니다.

비용은 얼마인가요?

Gemini CLI는 무료로 설치할 수 있고, 모델 사용은 무료 할당량이나 내 Google 요금제로 충당됩니다. LaunchRepo는 현재 가격 기준 €119.00 1회 결제로, 본인 제품 무제한, 어떤 에이전트로든 쓸 수 있습니다.

에이전트에게 출시 플레이북을 건네세요

현재 가격은 €119.00이며, 한 번 결제로 본인 제품 무제한, 어떤 에이전트로든 쓸 수 있습니다. 가격은 오르지 않습니다.

가격 보기