Claude Codex

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

Anthropic Claude를 Codex에서 직접 호출합니다. 멀티 프로바이더 오케스트레이션의 실행부(leaf)로 쓰도록 설계했습니다.

비공식 프로젝트. Claude / Anthropic 상표는 Anthropic 소유입니다.
Hermes 플러그인이 아닙니다. hermes-agent에서 Messages API 변환 아이디어만 참고했습니다. 대응표: docs/SOURCE_MAP.md

빠른 시작

# 마켓플레이스 등록
codex plugin marketplace add "/path/to/Claude Codex"
codex plugin add claude-codex@claude-codex

# 동의
python3 scripts/claude_codex_consent.py grant --i-understand-and-consent

# API 키
export ANTHROPIC_API_KEY=sk-ant-...

# 진단
python3 scripts/claude_codex_doctor.py

구독 로그인 (Claude Max/Pro)

기본 인증은 Claude Code 구독 OAuth입니다 (API key 아님).

claude auth login --claudeai
# macOS Keychain → 파일 미러 (권장)
python3 scripts/claude_codex_login.py mirror-keychain
python3 scripts/claude_codex_consent.py grant --i-understand-and-consent
python3 scripts/claude_codex_login.py status

구독 할당량(plan lane)을 쓰려면 hermes-claude-auth와 동일한 Claude Code 요청 핑거프린트가 OAuth 요청에 자동 적용됩니다 (Meapri/hermes-claude-auth).

API 키 강제: CLAUDE_CODEX_AUTH_MODE=api_key

MCP 도구

Tool	역할
claude_codex_consent_status	동의 상태
claude_codex_provider_status	API 키 준비 여부 (시크릿 없음)
claude_codex_chat	Messages API 채팅
claude_codex_list_models	모델 목록
claude_codex_doctor	로컬 진단

환경 변수

변수	의미
ANTHROPIC_API_KEY	Anthropic API 키 (권장)
ANTHROPIC_BASE_URL	기본 https://api.anthropic.com
CLAUDE_CODEX_USER_CONSENT=1	프로세스 단위 동의
CLAUDE_CODEX_MODEL	기본 모델 오버라이드
CLAUDE_CODEX_CONFIG_DIR	설정 디렉터리 오버라이드

개발

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

라이선스

MIT — LICENSE. Hermes 참고 고지: NOTICE.md.