Ollama 프로바이더 연결 (NanoClaw)
NanoClaw 에이전트 그룹을 Anthropic API 대신 로컬 Ollama 모델로 라우팅해 API 비용 없이 돌리게 해줍니다.
무엇을 해주나
NanoClaw로 띄운 에이전트 그룹의 요청 대상을 Anthropic API에서 로컬 Ollama 서버로 바꿔줍니다. Ollama가 Anthropic 호환 v1/messages 엔드포인트를 제공하기 때문에 프로바이더 코드를 새로 짤 필요 없이 환경변수(ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, NO_PROXY)와 모델 설정만 바꾸면 됩니다.
구체적으로는 (1) ContainerConfig에 env/blockedHosts 필드가 있는지 점검하고 없으면 추가, (2) groups/<폴더>/container.json에 환경변수 주입, (3) 에이전트 그룹 공유 settings.json에 모델명 기입, (4) 빌드 후 서비스 재시작, (5) docker inspect와 /api/ps로 실제 적용 여부 검증까지 안내합니다. api.anthropic.com을 0.0.0.0으로 막아 실수로 유료 API가 호출되는 것을 방지하는 옵션도 포함되어 있고, 되돌리는 방법과 흔한 오류 4가지 트러블슈팅도 정리되어 있습니다.
이런 분께 추천
- NanoClaw를 이미 운영 중이고 API 요금을 줄이고 싶은 분
- 사내망/오프라인 환경에서 오픈웨이트 모델로 에이전트를 돌려야 하는 분
- Docker, launchd/systemd, pnpm 빌드에 익숙한 중급 이상 개발자
주의: NanoClaw 프로젝트 전용입니다. 일반적인 Claude Code 사용자에게는 해당되지 않습니다.
활용 예시
- "내
research에이전트 그룹을qwen3-coder로 바꿔줘" → container.json 환경변수 + settings.json 모델 수정 후 재시작까지 자동 진행. - "실수로 Anthropic 요금 나가는 것 막아줘" →
blockedHosts: ["api.anthropic.com"]를 추가해 컨테이너 내부에서 도달 불가로 만듦. - "에이전트는 응답하는데 Ollama에 활동이 안 보여" →
no_proxy소문자 누락 진단 등 트러블슈팅 절차 수행.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-ollama-provider 폴더를 내 ~/.claude/skills/add-ollama-provider/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-ollama-provider ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r nanoclaw/.claude/skills/add-ollama-provider ~/.claude/skills/ - 사전 준비: Ollama 설치 후 실행하고
curl -s http://localhost:11434/api/tags로 응답을 확인합니다.ollama pull <모델명>으로 모델을 미리 받아둡니다. - NanoClaw 프로젝트 루트에서 Claude Code를 실행하고 "add-ollama-provider 스킬로 <그룹명>을 Ollama로 바꿔줘"라고 요청합니다.
- 스킬이 안내하는 대로 빌드(
pnpm run build)와 서비스 재시작까지 마친 뒤,docker exec <컨테이너> env | grep ANTHROPIC으로 적용을 확인합니다.