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

OpenCode 프로바이더 추가 (NanoClaw)

NanoClaw 에이전트 그룹의 백엔드를 Anthropic SDK 대신 OpenCode(OpenRouter·DeepSeek·Google 등)로 교체하는 설치 가이드 스킬입니다.

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

무엇을 해주나

NanoClaw는 컨테이너 안에서 에이전트를 폴링 루프로 돌리고, 그룹별 container.json의 provider 키로 백엔드를 고릅니다. 기본값은 claude이며 trunk 브랜치에는 claude 프로바이더만 들어 있습니다.

이 스킬은 providers 브랜치에서 OpenCode 프로바이더 소스를 가져와 호스트/컨테이너 배럴(index.ts)에 등록하고, @opencode-ai/sdk@1.4.17를 설치하고, Dockerfile에 opencode-ai CLI를 핀 버전으로 추가한 뒤 이미지를 다시 빌드하는 전 과정을 단계별로 안내합니다. 등록 가드 테스트 2개와 Dockerfile 구조 검증 테스트까지 복사해 배선이 끊기면 즉시 빨간불이 나도록 만듭니다.

추가로 OpenRouter·DeepSeek·Anthropic·OpenCode Zen용 .env 예시, OneCLI 시크릿 등록 방법(Bearer vs x-api-key), 기존 그룹 오버레이 갱신 스크립트, 세션 UUID/프록시 관련 트러블슈팅까지 정리돼 있습니다.

이런 분께 추천

  • NanoClaw를 직접 운영하며 모델 비용을 줄이거나 다른 벤더 모델을 쓰고 싶은 운영자
  • 컨테이너 이미지·Dockerfile·pnpm/bun 빌드 파이프라인을 직접 만질 수 있는 개발자
  • 그룹 단위로 여러 LLM 백엔드를 A/B 비교하려는 팀

활용 예시

  1. "DeepSeek으로 비용 절감하기" — .env에 OPENCODE_PROVIDER=deepseek, ANTHROPIC_BASE_URL=https://api.deepseek.com/v1을 넣고 OneCLI에 키를 등록한 뒤 테스트 그룹만 ncl groups config update --provider opencode로 전환.
  2. "OpenRouter로 모델 비교" — 큰 작업은 anthropic/claude-sonnet-4, 가벼운 작업은 claude-haiku-4.5로 OPENCODE_SMALL_MODEL을 분리해 운영.
  3. "빌드 후 Unknown provider 오류 해결" — docker builder prune -f && ./container/build.sh로 캐시를 비우고, 기존 그룹의 data/v2-sessions/*/agent-runner-src/providers/ 오버레이에 새 파일을 복사.

· · · 설치 가이드 · · ·

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

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

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

직접 명령으로 설치하기

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

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

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 폴더를 Claude Code가 읽는 위치로 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-opencode ~/.claude/skills/
  3. 실제 작업은 NanoClaw 저장소 안에서 진행해야 합니다. cd nanoclaw로 이동하고 Docker, pnpm, bun, OneCLI가 설치돼 있는지 확인하세요.
  4. Claude Code를 실행하고 "add-opencode 스킬로 OpenCode 프로바이더를 붙여줘"라고 요청합니다.
  5. 스킬 안내에 따라 git fetch origin providers → 소스 복사 → 배럴에 import './opencode.js'; 추가 → bun add @opencode-ai/sdk@1.4.17 순서로 진행합니다. 버전은 반드시 CLI와 동일하게 핀하고 latest는 쓰지 마세요.
  6. container/Dockerfile에 ARG OPENCODE_VERSION=1.4.17과 pnpm install -g "opencode-ai@${OPENCODE_VERSION}" 블록을 추가한 뒤 ./container/build.sh로 이미지를 빌드합니다.
  7. pnpm run build, 등록 가드 테스트, Dockerfile 가드 테스트가 모두 통과하는지 확인합니다.
  8. .env에 OPENCODE_* 값을 넣고 OneCLI에 API 키를 등록한 뒤 ncl groups config update --id <group-id> --provider opencode && ncl groups restart --id <group-id>로 테스트 그룹만 먼저 전환해 메시지를 보내 봅니다.
GitHub에서 원본 보기 ↗라이선스: MIT