Grok Codex

버전 0.2.0 · OpenAI Codex Desktop / GUI용 플러그인 + MCP stdio leaf.

xAI Grok를 Codex에서 직접 호출합니다. 오케스트레이션 플러그인의 leaf로 쓰기 좋게 얇게 만들었습니다.

비공식 프로젝트. Grok / xAI 상표는 xAI 소유입니다.
Hermes가 아닙니다. hermes-agent에서 xAI 엔드포인트·헤더·Responses 아이디어만 참고. docs/SOURCE_MAP.md

빠른 시작

codex plugin marketplace add "/path/to/Grok Codex"
codex plugin add grok-codex@grok-codex

python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
export XAI_API_KEY=xai-...

python3 scripts/grok_codex_doctor.py

Related MCP server: Grok MCP

구독 로그인 (SuperGrok / X Premium+)

기본 인증은 xAI device-code OAuth (Hermes xai-oauth와 동일 패턴).

python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
python3 scripts/grok_codex_login.py interactive
# 브라우저에서 accounts.x.ai 승인
python3 scripts/grok_codex_login.py status

MCP: grok_codex_login_start → 브라우저 승인 → grok_codex_login_complete

API 키 강제: GROK_CODEX_AUTH_MODE=api_key + XAI_API_KEY

MCP 도구

grok_codex_chat 옵션:

• api_mode: chat (기본) | responses

• session_id: 대화 친화 캐시용 (x-grok-conv-id)

환경 변수

개발

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest

라이선스

MIT — LICENSE. NOTICE.md.