로컬 Codex 프로젝트에 웹 ChatGPT를 안전하고 복구 가능한 실행 계층으로 연결합니다.
Important
이 저장소는 커뮤니티 프로젝트이며 OpenAI의 공식 제품이 아닙니다. ChatGPT 로그인, Developer Mode 앱 등록, DevSpace Owner 승인은 사용자가 직접 수행합니다.
| Guarded | Recoverable | Web-first | Cross-platform |
|---|---|---|---|
| 정확한 프로젝트 루트와 미션 SHA를 실행 전에 고정합니다. | 끊긴 실행을 새로 보내지 않고 기존 Oracle 세션에서 회수합니다. | 계획·리서치·구현·검토를 웹 ChatGPT 세션에 분리해 맡깁니다. | 영수증 기반 설치·롤백을 Windows와 macOS에서 검증합니다. |
Codex Web GPT Automation은 Oracle로 로그인된 ChatGPT 브라우저 세션을 실행하고, DevSpace로 사용자가 허용한 프로젝트만 웹 GPT에 노출합니다. 로컬 Codex는 제출 신원, 복구, 해시, 최종 결정론적 테스트를 책임집니다.
로컬 Codex
└─ UTF-8 미션 + exact project root + SHA-256
└─ Oracle → 로그인된 웹 ChatGPT 세션
└─ DevSpace → 승인된 프로젝트만 읽기/작업
└─ 결과 회수 → 신원·해시·최종 gate
git clone https://github.com/ventianima-lab/codex-web-gpt-automation.git
cd codex-web-gpt-automation
.\install.ps1 -WhatIf
.\install.ps1
python doctor.pygit clone https://github.com/ventianima-lab/codex-web-gpt-automation.git
cd codex-web-gpt-automation
python3 install.py --dry-run
python3 install.py
python3 doctor.py대화형 최초 설치는 선택 기능인 Local Multi-GPT를 설치할지 묻고 기본값은
No입니다. 설치기는 기존 전역 파일을 백업하고 ~/.codex/receipts에 영수증을
남깁니다. 설치 후 Codex를 재시작하세요.
Note
파일 설치만으로 ChatGPT 연결이 끝나지는 않습니다. 아래 최초 연결 절차를 한 번 완료해야 합니다.
순서를 바꾸지 않는 것이 중요합니다. 전체 명령과 분기 기준은 최초 설치 가이드가 권위 문서입니다.
- 고정 공개 경로 선택 — Tailscale Funnel 권장, Cloudflare Named Tunnel, ngrok 고정 도메인, custom HTTPS proxy 지원
- DevSpace 설정 — 사용할 모든 exact project root와 public origin 등록
- Owner 승인 정보 보존 — 암호를 CLI·Git·로그에 복사하지 않음
- 재부팅 복구 검증 — local/public endpoint와 root persistence 확인
- Oracle 전용 브라우저 로그인 — 일상 Chrome과 분리된 프로필
- ChatGPT 앱 수동 등록 — 이름
codex, URLhttps://고정주소/mcp - 일반 GPT 연결 검사 — Pro를 소비하지 않고
@codexread probe 수행
ChatGPT 앱 codex 등록은 준비가 끝난 뒤 최초 한 번 수동 등록하는
절차입니다. ChatGPT 설정·앱 목록·권한·삭제·선택 UI를 자동화하지 않습니다.
새 프로젝트를 추가할 때는 기존 root를 보존한 전체 목록에 exact folder만 추가합니다. 앱 설정은 매 작업마다 재검사하거나 자동 조작하지 않습니다.
| 원하는 결과 | 모드 | 실행 경로 |
|---|---|---|
| 질문·분석·작은 작업 | direct |
Oracle + DevSpace |
| 구현 전 설계 | plan |
읽기 전용 웹 세션 |
| 코드·계획 독립 검토 | review |
읽기 전용 웹 세션 |
| 범위가 정해진 수정 | edit |
웹 구현·테스트 |
| 한 번에 끝내는 실행 | orchestrator |
단일 웹 세션 |
| 공개 자료 심층 조사 | deep-research |
Oracle Deep Research |
| 독립 관점 병렬 탐색 | Web Multi-GPT | 여러 Oracle 세션 + merger |
| PC 로컬 자문·반례 탐색 | Local Multi-GPT | 선택 설치, Luna Max, 읽기 전용 |
| 계획부터 최종 gate까지 | comprehensive mode | 단계별 웹 워크플로 |
| 로컬 비용 최소화 | ultra-economy |
Luna Max 지휘 + 분리 웹 단계 |
| Power 5 단일 실행 | pro 호환 별칭 또는 명시 모드 + Pro |
모드 권한 + GPT-5.6 Sol Power 5 |
Power 1-5는 권한이 아니라 추론 수준입니다. direct·plan·review는 어느
Power에서도 읽기 전용이고, 명시적으로 승인된 edit·orchestrator는 Power
5에서도 정확한 프로젝트 root 안에서 수정과 테스트를 수행할 수 있습니다.
DevSpace가 제출 전에 확정적으로 불가능하고 workspace 무변경이 증명된 경우에만
같은 Power의 해시 결박 첨부 폴백을 한 번 사용합니다.
자세한 선택 기준은 전역 라우팅, 초절약모드는 초절약모드 가이드를 참고하세요.
프로젝트 안에 UTF-8 미션을 만들고 먼저 dry-run으로 신원을 확인합니다.
python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `
--mode orchestrator `
--project-root C:\project `
--mission-path C:\project\mission.md `
--manifest-output C:\project\.ai-bridge\oracle.json `
--reasoning-level Pro `
--fallback-contract C:\project\.ai-bridge\fallback-contract.json `
--dry-run쓰기 모드는 fallback-contract.json에 허용 edit path, preimage SHA-256, 허용
operation과 local gate를 명시해야 합니다. 실제 실행 승인이 있을 때만
--dry-run을 제거합니다.
- 프로젝트마다 활성 또는 불확실한 Oracle 작업은 하나만 둡니다.
- 새 프로젝트의 첫 DevSpace 제출 전에 exact root 등록을 확인합니다.
- Power는 권한을 바꾸지 않습니다. 명시적으로 승인된
edit또는orchestrator임무만 exact root 안에서 쓰기·셸·명령 실행을 허용합니다. - 제출 후 오류는 기존 실행 신원으로 정확히 복구하며, 저장된 slug와 대화 URL만 회수하고 자동 재제출하지 않습니다.
- 브라우저나 로컬 프로세스 종료만으로 웹 작업 실패를 판정하지 않습니다.
- 비밀, Owner 암호, OAuth 토큰, 브라우저 프로필은 저장소에 넣지 않습니다.
codexpro-*이름은 기존 영수증·스키마·복구 자산의 내부 호환 ID일 뿐, 새 작업용 제품명이나 실행 경로가 아닙니다.
보안 문제는 공개 이슈 대신 보안 정책의 비공개 경로로 알려주세요.
| 시작 | 운영 | 고급 모드 | 프로젝트 |
|---|---|---|---|
| 최초 설치 | DevSpace + Tailscale | 초절약모드 | 아키텍처 개요 |
| 문서 인덱스 | 전역 라우팅 | Local Multi-GPT | 변경 기록 |
| 기여 가이드 | macOS Ultrawork | 레거시 경계 | 버전 정책 |
이 프로젝트는 MAJOR.MINOR.PATCH 형식의 Semantic Versioning을
사용합니다. package.json, package-lock.json, install-manifest.json, Git 태그와
GitHub Release가 같은 버전을 가리켜야 합니다. 업그레이드 전에는
변경 기록을 확인하세요.
현재 검증 기준은 Oracle 0.17.1, DevSpace 1.0.4, Node.js >=22.19 <27,
Windows 11 및 macOS 12 이상입니다.
MIT License. Oracle·DevSpace 등 제3자 구성요소의 저작권과 라이선스는 THIRD_PARTY_NOTICES.md에 정리되어 있습니다.