Kodex

한국어로 자연스럽게 입력하면, kodex가 실제 codex CLI를 그대로 띄운 뒤 Enter 순간에만 프롬프트를 영어로 번역해서 전달합니다. Codex는 영어 프롬프트를 읽고, 답변은 한국어로 하도록 조용히 지시가 붙습니다.

kodex 자체가 코딩 에이전트가 되는 것이 아니라, 실제 OpenAI Codex CLI 앞에 붙는 얇은 인터셉트 레이어입니다.

사용법

npm install -g @3xhaust/kodex

kodex
kodex resume --last
kodex -m gpt-5.5
kodex --help

kodex가 직접 처리하는 서브커맨드가 아니면 모든 인자는 실제 codex로 그대로 전달됩니다.

로컬에서 개발 중인 버전을 설치하려면:

npm install
npm run build
npm install -g .

동작 방식

사용자 키보드 -> node-pty -> codex
codex 출력    <- node-pty <- 화면 미러

Enter 감지 -> 입력창 추출 -> 한국어면 번역 -> 입력창 교체 -> Enter 전달

• codex TUI는 그대로 사용합니다.
• /command, @path, 코드 블록, URL은 번역에서 보호합니다.
• 자동완성, 선택 메뉴, 모달, 첨부 마커에서는 Enter를 그대로 통과시킵니다.
• Ctrl+Enter를 누르면 번역 없이 원문 그대로 제출합니다.
• 번역 백엔드가 준비되지 않아도 실제 codex는 실행하고, 한국어는 원문 그대로 통과시킵니다.

번역 백엔드

기본 백엔드는 Codex입니다. kodex가 메인 인터랙티브 Codex 세션과 별개로 codex exec --ephemeral을 짧게 호출해서 번역만 수행합니다. 그래서 Codex 로그인만 되어 있으면 별도 API 키 없이 동작합니다.

kodex
kodex config set backend codex
kodex config set backend codex:gpt-5.5

Anthropic Haiku나 로컬 Ollama 백엔드로 바꿀 수도 있습니다.

export ANTHROPIC_API_KEY=...
kodex config set backend haiku

kodex config set backend ollama:gemma3:4b
kodex model list
kodex model use qwen2.5:7b

환경변수로도 지정할 수 있습니다.

KODEX_BACKEND=codex kodex
KODEX_BACKEND=codex:gpt-5.5 kodex
KODEX_BACKEND=ollama:gemma3:4b kodex
KODEX_CODEX_BIN=/absolute/path/to/codex kodex
KODEX_DUMP_POPUP=1 KODEX_DUMP_KEYS=1 kodex

설정과 로그는 ~/.kodex 아래에 저장됩니다.

명령

kodex config get
kodex config set backend codex
kodex config set backend haiku
kodex config set backend ollama:gemma3:4b
kodex config set debug true

kodex glossary list
kodex glossary add 리액트 React
kodex glossary remove 리액트

kodex install-rules
kodex uninstall-rules

install-rules는 선택적으로 ~/.codex/AGENTS.md에 토큰 절약 규칙 블록을 추가합니다.

참고

이 프로젝트는 Leviosa-AI/klaude의 구조와 아이디어를 참고해 Codex CLI용으로 만든 변형입니다. PTY 래핑, 화면 미러링, Enter 시점 번역 인터셉트, 토큰 보호 전략의 큰 틀은 klaude에서 출발했습니다.

원본 klaude는 MIT License로 배포되며, 원 저작권 고지는 이 저장소의 LICENSE에 보존되어 있습니다.