클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Codex 에이전트 프로바이더 설치 (NanoClaw)

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

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

무엇을 해주나

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

  • providers 브랜치에서 호스트/컨테이너/설치용 페이로드 파일 복사
  • 5개 배럴 파일에 import './codex.js'; 자동 추가 (멱등)
  • container/cli-tools.json에 @openai/codex 핀 버전 추가 후 이미지 재빌드
  • provider-contract-verifier로 등록 검증
  • ChatGPT 구독 로그인 또는 OpenAI API 키를 볼트(vault)에 저장하는 인증 walk-through

자격증명은 .env에 남지 않고 게이트웨이가 컨테이너에는 더미 auth.json만 노출한 뒤 실제 토큰을 와이어에서 교체합니다.

이런 분께 추천

  • NanoClaw를 실제로 운영 중이며 그룹마다 다른 모델 백엔드를 쓰고 싶은 운영자
  • Claude 구독 한도를 분산하거나 Codex의 서버측 대화 히스토리·MCP 도구를 쓰고 싶은 분
  • 수동 편집 대신 문서 자체를 결정적으로 적용하는 설치 방식(nc: 디렉티브)에 관심 있는 분

※ NanoClaw 저장소가 아니면 동작하지 않습니다.

활용 예시

  1. 원커맨드 설치: pnpm exec tsx setup/index.ts --step provider-auth codex 로 파일 복사·배럴 배선·재빌드·인증을 한 번에 처리.
  2. 그룹 단위 전환: ncl groups config update --id <group-id> --provider codex 후 ncl groups restart 로 특정 채팅 그룹만 Codex로 운용.
  3. 장애 진단: 컨테이너가 부팅 직후 죽으면 grep 'Container exited non-zero' logs/nanoclaw.error.log 로 Unknown provider: codex 여부를 확인해 배럴 배선 누락을 잡아냄.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-codex/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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. 터미널을 열고 작업할 디렉터리로 이동합니다.
  2. NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  3. 스킬만 별도로 쓰려면 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/
  4. 실제 설치는 NanoClaw 저장소 안에서 실행해야 합니다. cd nanoclaw 후 src/project-doc-compose.ts 파일이 있는지 확인하세요. 없으면 먼저 /update-nanoclaw 를 실행합니다.
  5. Claude Code를 실행하고 "add-codex 스킬로 Codex 프로바이더를 설치해줘"라고 요청하거나, 직접 pnpm exec tsx setup/index.ts --step provider-auth codex 를 실행합니다.
  6. 안내에 따라 ChatGPT 구독 로그인 또는 OpenAI API 키를 입력해 볼트에 저장합니다.
  7. 사용할 그룹에서 ncl groups config update --id <group-id> --provider codex 와 ncl groups restart --id <group-id> 를 실행합니다.
GitHub에서 원본 보기 ↗라이선스: MIT