A Codex-powered Chrome side-panel assistant for page context, tabs, voice, and image workflows.
이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.
Chromex는 Chrome MV3 사이드 패널 어시스턴트로, 로컬 네이티브 브리지를 통해 Chrome을 Codex에 연결합니다. 현재 페이지, 선택한 탭, 업로드된 파일, 음성 입력, 이미지, 브라우저 워크플로우를 사용하면서 자격 증명을 확장 프로그램 저장소에 저장하지 않도록 도와줍니다.
GenexisAI CHOI가 게시했습니다.
!Chromex 브라우저 사이드 패널 어시스턴트
Chrome 웹 스토어 사용자는 Chromex를 소스에서 빌드할 필요가 없습니다.
영어, 한국어, 일본어, 중국어 간체로 복사 버튼이 포함된 단계별 가이드는 공개 설정 페이지를 사용하세요: <https://genexis-ai.github.io/chromex/install/>
npm install -g @openai/codex
codex --versionChromex는 @openai/codex 0.130.0 이상이 필요합니다. 이전 릴리스(예: 0.124.x 및 0.125.x)는 일부 부트스트랩 기능 플래그를 거부하며, codex login 성공 직후 codex app-server exited with code 1로 표시됩니다.
chromex-local-bridge.zip을 다운로드하고 압축을 푼 후 다음을 실행하세요:node scripts/install-native-host.mjs --browser=chrome스토어 확장 프로그램은 이 일회성 로컬 브리지 등록 후에만 실행할 수 있습니다. 브리지는 Chrome이 Chrome 네이티브 메시징을 통해 안전하게 로컬 Codex 앱 서버를 시작할 수 있게 합니다. 확장 프로그램 자체는 해당 로컬 호스트를 자동으로 설치할 수 없습니다.
소스 체크아웃 또는 chromex-public-source.zip을 사용하세요:
git clone https://github.com/GENEXIS-AI/chromex.git
cd chromex
npm install
npm run build
node scripts/install-native-host.mjs그런 다음 모든 Chrome 창을 닫고 Chrome을 다시 연 다음 chrome://extensions를 열고 개발자 모드를 활성화한 후 압축 해제된 확장 프로그램 로드를 선택하고 다음을 선택하세요:
packages/extension/dist중요: package.json이 포함된 chromex 소스 폴더에서 npm install, npm run build, install-native-host.mjs를 실행하세요. Windows에서 ENOENT Could not read package.json이 보고되면 잘못된 폴더에 있는 것입니다.
Windows에서는 Node.js 20 LTS 이상을 설치한 후 먼저 Codex CLI를 설치하고 확인하세요:
npm install -g @openai/codex
codex --versionwinget install Codex -s msstore가 실패하더라도 위의 npm 설치 경로를 사용하세요. 0x8a15005e: The server certificate did not match any of the expected values는 Chromex 설치 단계가 아닌 Windows 스토어/TLS 인증서 체인 문제입니다.
그런 다음 chromex 소스 폴더에서 PowerShell을 사용하세요:
npm install
npm run build
node scripts/install-native-host.mjs --browser=chrome그런 다음 chrome://extensions를 열고 Chromex에서 새로고침을 클릭한 후 Chromex 사이드 패널에서 연결 확인을 누르세요.
사이드 패널에 여전히 로컬 브리지가 대기 중이라고 표시되면:
packages/extension/dist에서 로드되었는지 확인하세요.chrome://extensions에서 Chromex 카드에 표시된 확장 프로그램 ID를 복사하세요.node scripts/install-native-host.mjs <extension-id> --browser=chrome예상 공개 릴리스 ID는 menmlhahmendmkiicbjihgjhppkgaeom입니다. Chrome에 다른 ID가 표시되면 Chrome에 표시된 ID를 사용하세요.
Failed to start codex app-server로 로그인이 실패하면 Chromex가 로컬 브리지에 도달할 수 있지만 Codex CLI를 시작할 수 없습니다. codex --version을 다시 실행하세요. Windows에서 찾을 수 없으면 선택적 Codex 바이너리 경로를 %APPDATA%\npm\codex.cmd로 설정하거나 폴더를 %APPDATA%\npm으로 설정하세요. Codex 바이너리 필드에 작업 공간 폴더를 넣지 마세요. 작업 공간 폴더와 Codex 실행 파일 경로는 별도의 설정입니다.
Windows에서 실행 파일 감지를 강제하려면:
npm install -g @openai/codex
where codex
codex --versionwhere codex가 C:\Users\<you>\AppData\Roaming\npm\codex.cmd를 출력하면 Chromex 설정을 열고 선택적 Codex 바이너리 경로를 %APPDATA%\npm\codex.cmd로 설정하고 저장한 후 모든 Chrome 창을 닫고 Chrome을 다시 연 다음 연결 확인을 누르세요.
Chromex는 다음 경계를 사용합니다:
Chrome 확장 프로그램 -> 네이티브 메시징 호스트 -> 로컬 브리지 -> codex app-server소스 트리는 다음과 같이 구성됩니다:
packages/extension: Chrome MV3 사이드 패널 확장 프로그램packages/bridge: Codex 앱 서버 및 멀티모달 워크플로우를 위한 로컬 브리지 데몬packages/native-host: Chrome 네이티브 메시징 릴레이packages/shared: 공유 타입, 정책, 프로필 및 헬퍼Chromex는 기본적으로 브라우저 언어를 자동으로 따릅니다. 사용자는 설정 > 일반 > 앱 UI 언어에서 언어를 선택할 수도 있습니다.
확장 프로그램은 영어, 한국어, 일본어, 중국어, 아랍어, 프랑스어, 독일어, 스페인어, 포르투갈어, 힌디어, 베트남어, 태국어, 터키어, 우크라이나어 및 기타 Chrome 호환 로케일에 대한 Chrome _locales 항목을 제공합니다. 모델 응답은 사용자가 다른 언어를 요청하지 않는 한 선택한 UI 언어를 따르도록 지시됩니다.
history, tabs, 화면 캡처, 마이크 및 사이트 액세스는 기능이 필요할 때만 요청됩니다.수정된 빌드를 게시하거나 배포하기 전에 SECURITY.md 및 PRIVACY.md를 읽으세요.
@ 선택기./ 선택기..codex/skills/*/SKILL.md에서 로드되는 선택적 Codex 스킬.npm install
npm run typecheck
npm run test
npm run build
npm run release:audit선택적 브라우저 스모크 테스트:
npm run smoke호환되는 브라우저가 없으면 Playwright Chromium 런타임을 설치하세요:
npm run smoke:install-browser빌드된 확장 프로그램은 다음 위치에 출력됩니다:
packages/extension/distChromex는 0.1.1부터 일반 오픈 소스 릴리스 기록을 사용합니다. 버전 관리, 풀 리퀘스트 흐름 및 릴리스 체크리스트는 RELEASE.md에 문서화되어 있습니다.
npm run build를 실행한 다음 node scripts/install-native-host.mjs --browser=chrome을 실행하고 chrome://extensions에서 확장 프로그램을 새로고침한 후 Chromex 온보딩/시스템 상태를 확인하세요. Chrome에 다른 확장 프로그램 ID가 표시되면 node scripts/install-native-host.mjs <extension-id> --browser=chrome을 실행하세요.npm install -g @openai/codex, where codex, codex --version을 실행하세요. 필요한 경우 Chromex에서 선택적 Codex 바이너리 경로를 %APPDATA%\npm\codex.cmd로 설정하고 저장한 후 Chrome을 완전히 다시 시작하고 연결 확인을 누르세요.npm run build를 실행하고 확장 프로그램 카드를 새로고침한 후 Chrome이 packages/extension/dist를 로드하고 있는지 확인하세요.npm run smoke:install-browser를 실행한 다음 npm run smoke를 실행하세요.MIT. LICENSE를 참조하세요.