로컬 Codex 연동
로컬에 설치된 OpenAI Codex CLI를 Claude Code의 코딩 서브에이전트로 호출해 코드 생성·리팩터링·리뷰를 위임합니다.
개발·코딩중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 로컬
codexCLI를 자동 탐색(Codex 데스크톱 앱, npm 전역, Homebrew 등)해 비대화형 모드로 실행합니다. exec(단일 작업),review(코드 리뷰),status(상태 확인) 세 가지 명령을 파이썬 래퍼로 표준화합니다.- 결과를 JSON(
success,exit_code,elapsed_seconds,final_message등)으로 돌려주어 Claude가 후속 작업에 바로 활용할 수 있습니다. ~/.codex/auth.json의 ChatGPT Pro OAuth를 사용하며, API 키를 쓰지 않아 종량제 과금이 발생하지 않도록 설계됐습니다.- sandbox 모드(
read-only/workspace-write/danger-full-access)와 타임아웃, 모델(gpt-5.5등)을 파라미터로 제어합니다.
이런 분께 추천
- ChatGPT Pro 구독자로 Codex CLI를 이미 쓰고 있고, Claude Code와 병행해 두 모델을 교차 검증하고 싶은 개발자
- 리팩터링·리뷰처럼 반복적인 작업을 다른 에이전트에 넘기고 본 작업 흐름을 유지하려는 사람
- 커밋 전 미커밋 변경사항을 자동으로 리뷰받고 싶은 팀
활용 예시
- "codex로 이 저장소의 미커밋 변경사항을 리뷰해줘" →
review /path/to/repo gpt-5.5 true 300실행 후 리뷰 요약을 정리해 줍니다. - "피보나치 계산 파이썬 함수를 codex에게 만들라고 해" →
exec+workspace-write샌드박스로 파일을 생성합니다. - "codex 연결 상태 확인" →
status로 CLI 경로와 OAuth 인증 상태를 점검합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 local-codex 폴더를 내 ~/.claude/skills/local-codex/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/local-codex ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 먼저 OpenAI Codex CLI를 설치합니다(Codex 데스크톱 앱 또는
npm i -g @openai/codex, Homebrew 등). - 터미널에서
codex login을 실행해 브라우저 OAuth로 ChatGPT Pro 계정에 로그인합니다. (OPENAI_API_KEY는 설정하지 마세요 — 종량제로 전환됩니다.) python3 --version으로 파이썬 3가 설치돼 있는지 확인합니다.- 저장소를 클론합니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 복사합니다:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/local-codex ~/.claude/skills/ - Claude Code를 재시작한 뒤 "codex 상태 확인해줘"라고 요청해 정상 인식되는지 테스트합니다.
- 실제 작업은
read-only샌드박스로 먼저 시험하고, 파일 수정이 필요할 때만workspace-write를 사용하세요.
GitHub에서 원본 보기 ↗라이선스: MIT