Codex로 디렉터리에 SaaS 출시하기

Codex에 필요한 것

Codex CLI 또는 IDE 확장 프로그램

구매 후 클론한 비공개 저장소에서 Codex를 시작하세요. CLI, IDE 확장 프로그램, ChatGPT 데스크톱 앱은 MCP 설정 하나를 공유하므로, 브라우저 서버를 한 번 추가하면 세 곳 모두에서 쓸 수 있습니다.

Python 3.10+와 Node.js LTS

Python은 워크스페이스 생성, record.py, 대시보드를 실행하며 표준 라이브러리만 씁니다. Node.js는 npx를 제공하고, Codex는 이를 이용해 Chrome DevTools MCP를 stdio 서버로 띄웁니다.

config.toml의 테이블 하나

Codex는 MCP 서버를 ~/.codex/config.toml의 [mcp_servers.<name>] 아래에 둡니다. 프로젝트 단위 .codex/config.toml은 신뢰한 프로젝트에서만 읽으므로, 홈 폴더의 파일이 가장 확실한 위치입니다.

authorizations.json의 제품 규칙

Codex의 승인 설정은 도구 실행 전에 언제 물을지를 정합니다. LaunchRepo의 권한은 이 제품에 대해 무엇을 해도 되는지를 정합니다. 무료 가입, 최종 제출, 메일 작업, 배지입니다. 어떤 승인 모드에서도 지출은 없습니다.

Codex를 내 Chrome에 연결하기

Codex는 내가 건네준 MCP 서버를 통해서만 브라우저를 조작합니다. LaunchRepo의 브라우저 가이드는 새 프로필보다 평소 쓰는 Chrome을 권장합니다. Chrome 144 이상에서 chrome://inspect/#remote-debugging의 원격 디버깅을 켜고, 서버가 --autoConnect로 연결되게 하세요.

명령어가 편하다면 codex mcp add chrome-devtools 뒤에 이중 대시와 같은 npx 줄을 붙여도 똑같은 항목이 기록됩니다. 네이티브 Windows에서는 공식 클라이언트 가이드가 npx를 cmd /c로 감싸고 SystemRoot와 PROGRAMFILES를 설정하니, Unix 예시 대신 그 가이드를 따르세요.

아래 항목은 ~/.codex/config.toml에 들어갑니다. startup_timeout_sec는 Codex의 기본값 10초를 늘려 주는데, 첫 npx 다운로드는 이 시간을 넘길 수 있습니다.

[mcp_servers.chrome-devtools]
command = "npx"
args = [
  "-y",
  "chrome-devtools-mcp@latest",
  "--autoConnect",
  "--no-usage-statistics",
  "--no-performance-crux"
]
startup_timeout_sec = 20

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

codex mcp list로 확인하거나 Codex TUI 안에서 /mcp를 입력하세요. 그런 다음 Codex에게 빈 탭에서 example.com을 열게 하고, Chrome의 요청을 허용한 뒤, 아무것도 로그인하기 전에 지금 보고 있는 탭이 움직였는지 확인하세요.

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

시작 프롬프트

클론한 폴더에서 START.md의 공개 시작 프롬프트를 Codex에 붙여 넣으세요. 프롬프트 첫 줄이 Claude Code CLI나 Codex CLI를 권장하므로, 터미널의 Codex는 프롬프트가 염두에 둔 바로 그 환경입니다. 비공개 워크스페이스를 만들고 대시보드를 띄운 뒤 127.0.0.1 링크로 답합니다.

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으로 되어 있습니다. 제품 문구는 디렉터리가 받는 언어라면 무엇이든 괜찮고, 에이전트는 내 언어로 답합니다.

이후에는 대시보드가 온보딩을 이끌고, 다음 세션마다 쓸 프롬프트를 보관합니다. Codex가 내 제품에 대해 알게 된 내용은 계속 열어 둬야 하는 채팅이 아니라, 다음번에 다시 읽는 파일에 남습니다.

세 단계로 LaunchRepo 시작하기 →

실행 모습

Codex는 승인 설정에 따라 실행 전이나 실행 중에 셸 명령과 도구 호출을 하나하나 보여 주고, Chrome에는 채워지는 양식이 보입니다. 아래 패널은 홈페이지의 샘플 배치입니다. 실제 상태는 submissions.json에 있습니다.

Codex가 Chrome에 닿지 못할 때

Codex에서 자주 걸리는 세 가지 문제와 문서에 나온 해결 방법입니다. 해결하는 동안에도 기록된 결과는 모두 트래커에 남아 있습니다.

서버가 제때 시작되지 않음

첫 npx 실행은 패키지를 내려받느라 Codex의 기본값 10초보다 오래 걸릴 수 있습니다. 테이블에 startup_timeout_sec = 20을 그대로 두거나, npx -y chrome-devtools-mcp@latest --help를 한 번 실행해 캐시를 미리 채워 두세요.

프로젝트 설정이 무시됨

Codex는 신뢰한 프로젝트에서만 .codex/config.toml을 읽습니다. 서버를 ~/.codex/config.toml로 옮기거나 폴더를 신뢰한 뒤, Codex를 재시작하고 /mcp를 다시 확인하세요.

Windows: 시작 시 “Connection closed”

네이티브 Windows에서는 npx를 cmd /c로 실행해야 합니다. 공식 클라이언트 가이드의 Windows 예시를 환경 변수 항목까지 그대로 쓰고, Codex를 재시작하세요.

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

여전히 내가 할 일

LaunchRepo는 일부러 백그라운드 서비스로 만들지 않았습니다. 아래 순간에는 실행이 멈추고 사람에게 넘기는 인계로 기록되며, 에이전트는 이를 절대 우회하지 않습니다.

CAPTCHA와 봇 확인

Codex는 해당 플랫폼에서 멈추고 prepared_needs_human으로 기록하며, 대시보드는 이를 “내 확인 필요” 아래에 둡니다. 보이는 탭에서 확인을 통과한 뒤 Codex가 이어서 하게 하세요. 그동안 배치 안의 다른 독립적인 플랫폼은 계속 진행될 수 있습니다.

2FA와 인증 코드

연결된 Chrome에서 메일함이 열려 있으면 Codex가 확인 링크를 직접 따라갈 수 있습니다. 그렇지 않으면 코드를 직접 전달하고, 트래커에는 사람에게 넘긴 인계로 기록됩니다.

유료 옵션 권유

비용이 드는 경로는 나중을 위한 메모와 함께 deferred_paid가 됩니다. 어떤 승인 모드로 실행하든 Codex는 구매하지 않고, 체험판을 시작하지 않으며, 관련 없는 제안도 수락하지 않습니다.

“게시됨” 확인

저장된 양식, 접수 확인, 감사 페이지는 각각 별도의 상태로 남습니다. 게시됨으로 표시하려면 공개 URL과 내 확인이 필요합니다.

벤치마크도 순위도 없습니다. Codex의 호환성을 말하는 이유는 위의 두 가지 요건을 충족하기 때문이지, 다른 에이전트와 비교해 측정했기 때문이 아닙니다.

자주 묻는 질문