클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Codex 에이전트 프로바이더 추가

NanoClaw에 OpenAI Codex app-server를 정식 에이전트 백엔드로 설치하고 그룹별로 전환하게 해주는 스킬입니다.

개발·코딩고급★ 30,471⑂ 12,865AI 점수 6/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

NanoClaw 프로젝트에서 Claude 대신(또는 Claude와 함께) OpenAI Codex app-server를 에이전트 프로바이더로 쓸 수 있게 설치 전 과정을 자동화합니다.

  • providers 브랜치에서 Codex 페이로드 파일을 호스트·컨테이너·셋업 세 트리에 복사
  • 세 개의 프로바이더 배럴(index.ts)에 자기등록 import 추가
  • container/cli-tools.json에 @openai/codex 고정 버전 항목 병합
  • 빌드 → 테스트 → OneCLI 자격증명 볼트 인증까지 안내
  • 그룹별 ncl groups config update --provider codex 전환 방법과 트러블슈팅 제공

모든 지시문(nc: 펜스)은 멱등이라 여러 번 실행해도 안전하며, API 키는 .env가 아닌 볼트에만 저장되어 컨테이너 내부에서 읽히지 않습니다.

이런 분께 추천

  • NanoClaw를 운영하며 그룹마다 다른 LLM 백엔드를 붙이고 싶은 운영자
  • ChatGPT 구독 또는 OpenAI API 키를 이미 보유하고 Codex 성능을 비교하려는 개발자
  • 컨테이너 이미지 재빌드와 pnpm/vitest/bun 워크플로에 익숙한 중급 이상 사용자

활용 예시

  1. 한 방 설치: pnpm exec tsx setup/index.ts --step provider-auth codex 를 실행해 파일 복사·배럴 연결·이미지 재빌드·인증을 한 번에 끝냅니다.
  2. 특정 그룹만 Codex로 전환: ncl groups config update --id my-group --provider codex && ncl groups restart --id my-group — 메모리는 memory/ 트리를 공유하므로 그대로 이어집니다.
  3. 장애 진단: 채널이 조용하면 grep 'Container exited non-zero' logs/nanoclaw.error.log 로 Unknown provider: codex 여부를 확인해 배럴 연결 누락을 잡아냅니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-codex 폴더를 내 ~/.claude/skills/add-codex/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 이 스킬은 저장소 안(.claude/skills/add-codex)에 이미 들어 있습니다. 다른 곳에서도 쓰려면 mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/ 를 실행하세요.
  3. 저장소 루트로 이동해 의존성을 설치합니다: cd nanoclaw && pnpm install
  4. Claude Code를 저장소 루트에서 실행한 뒤 "add-codex 스킬로 Codex 프로바이더를 설치해줘"라고 요청하거나, 직접 pnpm exec tsx setup/index.ts --step provider-auth codex 를 실행합니다.
  5. 안내에 따라 ChatGPT 구독 로그인 또는 OpenAI API 키를 입력하면 OneCLI 볼트에 저장됩니다.
  6. 빌드와 테스트가 통과하는지 확인합니다: pnpm run build && ./container/build.sh
  7. 원하는 그룹에서 ncl groups config update --id <그룹ID> --provider codex 후 ncl groups restart --id <그룹ID> 로 전환합니다.
GitHub에서 원본 보기 ↗라이선스: MIT