Nanocoder 가격: 무료 CLI, 모델 청구액 및 비용 푸터

Nanocoder는 무료입니다. CLI는 MIT 라이선스이고 계정·티어·라이선스 키가 없으므로, 실제로 "Nanocoder 가격"은 이를 뒷받침하는 모델 요금, 즉 구성한 공급자의 토큰 비용이나 로컬 모델의 하드웨어 및 전기 비용을 의미합니다. 터미널에 표시되는 숫자는 그 청구액이 아닙니다. Nanocoder는 게이트웨이 항목이 없는 서드파티 데이터베이스를 사용해 모든 응답의 가격을 계산하며, 이 페이지는 그 결과를 정확히 재현합니다.

먼저 검색 결과가 여러 항목을 섞기 때문에 구분해 두겠습니다. 이 페이지는 Nano-Collective/nanocoder를 다루며, @nanocollective/nanocoder로 배포되고 docs.nanocollective.org/nanocoder에 문서화되어 있습니다. 끝의 r에 유의하세요. NanoGPT용 코딩 에이전트인 nanocode라는 별도 프로젝트와 토큰을 판매하고 nano-gpt.com 및 nanogpt.net에서 실제 가격표를 게시하는 NanoGPT 자체, 그리고 Nanocoder라는 이름으로 사업하는 폴란드 소프트웨어 회사도 이러한 검색어로 순위에 나타납니다. 이들의 가격은 어느 것도 이 페이지에 해당하지 않습니다.

Nanocoder가 청구하는 비용과 실제로 청구되는 비용

문서화된 모든 경로에서 설치는 무료이며 계정을 요구하지 않습니다. npm install -g @nanocollective/nanocoder, Homebrew 또는 Nix를 사용할 수 있습니다. npm 레지스트리에는 1.30.0이(가) latest로 표시되어 있으며, 2026년 8월 26일에 게시되었고 engines.node >= 22 및 "license": "MIT"를 포함합니다(2026년 9월 21일 레지스트리 확인 당시 더 새로운 릴리스는 없었습니다).

이 프로젝트는 사용자에게 비용을 청구하는 대신 기부와 후원으로 자금을 조달합니다. 또한 다른 곳에서 읽게 될 조언의 성격을 결정하는 공개 사항이 하나 있습니다. Atlas Cloud는 Nanocoder 자체 README에 등재된 후원자이며, README에는 "더 예산 친화적인 API 액세스"를 위한 "코딩 플랜 프로모션" 링크도 있습니다. 이 추천은 후원자가 자금 지원에 참여하는 문서 안에 있으며, 해당 플랜이 가장 저렴하다는 증거는 아닙니다. 이 코딩 플랜은 주간 포인트가 제공되는 월간 구독이며, 포인트는 입력 토큰에 입력 배수를 곱한 값과 출력 토큰에 출력 배수를 곱한 값을 더한 만큼 소모됩니다. 배수는 모델별로 설정되므로 토큰 100만 개당 비용은 어떤 모델을 실행하는지에 따라 달라지며, 요금표 옆에 적을 수 있는 단일 수치가 아닙니다.

터미널의 비용 수치는 청구액이 아닙니다

버전 1.30.0은 모든 어시스턴트 메시지 아래에 예를 들어 Tokens: 4.2k | ~$0.01와 같은 바닥글을 추가했습니다. 화면에서 가장 유용해 보이는 숫자이자 가장 쉽게 잘못 해석되는 숫자입니다. Nanocoder는 공급자에게 얼마를 청구하는지 묻지 않기 때문입니다.

릴리스된 소스의 v1.30.0 태그에서 확인한 메커니즘은 다음과 같습니다. 가격은 models.dev/api.json에서 가져옵니다. 조회는 모델 ID를 사용하며 자체 주석에 따라 "모든 공급자를 검색하고 컨텍스트 한도가 가장 큰 일치 항목을 선택"하므로 구성한 공급자에는 조회하지 않고 ID 문자열만 사용합니다. 해당 파일을 2026년 9월 21일에 가져왔을 때 223개의 공급자와 Kunavo 항목 없음으로 표시되었습니다. 따라서 Kunavo가 제공하는 ID는 우연히 동일한 문자열을 보유하고 가장 큰 컨텍스트 창을 선언한 무관한 항목으로 해석됩니다.

동일한 파일에 동일한 알고리즘을 적용하여, 입력 토큰 200,000개와 출력 토큰 15,000개로 가정한 한 세션을 계산하면 아래와 같은 차이가 발생합니다. 카탈로그 추정치는 Kunavo 카탈로그 산술이며, 마지막 열은 동일한 토큰에 대해 Nanocoder 바닥글이 계산할 총액입니다.

하나의 조회에서 발생하는 두 가지 오류입니다. 선택된 항목이 더 높은 요금을 게시하면 바닥글이 과다 계산합니다. 선택된 항목이 요금을 0으로 게시하거나 cost 블록 자체를 게시하지 않으면 바닥글에 아무것도 표시되지 않으며, 비용이 없다는 것은 무료로 읽힙니다. 배포된 코드에서 마지막 단계는 의도된 동작입니다. 비용 블록이 없으면 "알 수 없음"이 아니라 0 요금으로 변환되며, 게시된 패키지의 포매터는 비용이 0 이하일 때 아무것도 반환하여 "무료/로컬 모델은 '$0.00' 대신 비용 구간을 표시하지 않아야 한다"고 처리합니다. 이 로직은 로컬 모델에는 올바르지만, 가격이 0인 디렉터리 항목과 ID가 충돌하는 유료 모델에는 잘못됩니다.

여기에 두 가지 왜곡이 더해집니다. models.dev는 일부 항목에 대해 장문 컨텍스트 가격 티어를 게시하지만, 릴리스된 클라이언트는 각 항목에서 평면적인 input 및 output 요금만 복사하고 티어는 전혀 읽지 않으므로 티어 임계값을 넘는 턴은 과소 계산됩니다. 또한 버전 1.30.0 자체의 변경 로그에는 추정치가 "모든 입력 토큰을 표준 요금으로 계산하며 캐시 읽기/쓰기 할인을 반영하지 않으므로 프롬프트 캐싱을 제공하는 공급자에서는 비용이 과다 계산될 수 있다"고 적혀 있습니다. 경로에서 이러한 할인이 어떻게 표시되는지는 프롬프트 캐싱을 참조하세요.

이 표의 요금은 스냅샷입니다. models.dev는 계속 수정되며, 컨텍스트가 가장 큰 항목을 선택하는 동률 해결 결과는 컴퓨터에서 아무것도 변경되지 않아도 달라질 수 있습니다. 재현 절차는 간단합니다. api.json을 가져오고, 정확한 모델 ID를 보유한 모든 공급자를 찾고, 가장 큰 limit.context을 가진 항목을 유지한 다음 해당 항목의 cost 블록을 읽습니다. 권위 있는 수치는 공급자 자체 원장에 있습니다. 청구 세부 정보를 참조하세요.

배포된 내용과 개발 브랜치에만 있는 내용

이 구분에 따라 사람들이 인용하는 여러 수정 사항이 실제로 컴퓨터에 존재하는지가 결정됩니다. 문서 사이트의 /latest/와 /v1.30.0/ 모두 2026년 9월 21일 확인 당시 v1.30.0 콘텐츠를 제공했으며, 저장소의 main 브랜치에 있는 docs/ 폴더는 두 문서보다 앞서 있습니다.

위의 각 "아니요"는 추론이 아니라 게시된 페이지를 grep하여 확인했습니다. Anthropic 공급자 페이지가 정상 여부를 확인하는 기준입니다. "Prompt caching"과 "cache-aware"는 0건이었고, 동일한 HTML에 sdkProvider은 6번 포함되어 있었습니다. 이는 렌더링 오류가 아니라 실제 부재입니다. 8월 26일 릴리스 이후 main에 반영된 작업에는 이 모든 항목이 추가되어 있으므로, main의 파일을 인용하면 아직 설치할 수 없는 소프트웨어를 설명하게 되며, 더 새로운 릴리스가 나오면 이 행 중 여러 개가 변경될 수 있습니다.

Nanocoder에 가장 적합한 모델: 순위가 아니라 기능에 관한 질문

Nanocoder는 추천 모델, 리더보드, 하드웨어 사양을 공개하지 않습니다. 2026년 9월 21일 문서를 전체적으로 확인했지만 최소 RAM, VRAM 수치, 추천 GPU는 없었고, 저장소의 benchmarks/ 디렉터리는 모델 점수가 아니라 완성된 CLI의 품질 보고서(종료 코드, 모듈 수, 대략적인 부팅 및 첫 렌더링 시간, 번들 크기)였습니다. 여기서 작업 벤치마크도 실행하지 않았으므로 이 페이지에는 순위를 싣지 않습니다. 아무것도 바탕으로 하지 않은 리더보드는 없는 것보다 나쁩니다.

공급자가 공개하는 내용은 어쨌든 예산 페이지에 더 적합합니다. 모델의 점수가 아니라 모델이 할 수 있는 일을 바꾸기 때문입니다. v1.30.0 tune 문서에 따르면 기본 auto 도구 프로필은 "클라우드 모델과 크기 힌트가 없는 모델 ID에는 전체 도구 표면을 유지하고, 최대 15B 매개변수 모델은 minimal로, 최대 4B 매개변수 모델은 nano로 해석합니다".

실무적으로 두 가지로 해석할 수 있습니다. 첫째, 문서에는 "MCP 도구는 해석된 full 프로필에서만 노출된다"고 명시되어 있습니다. 따라서 소형 로컬 모델에 MCP 서버를 연결해도 프로필을 수동으로 전환하거나 더 큰 모델로 이동하기 전까지는 아무 일도 일어나지 않습니다. 둘째, 번들로 제공되는 "Nano (저사양 하드웨어)" 프리셋은 최대 토큰 수를 2048로 제한하며, 이는 힌트가 아니라 실제 응답 길이의 상한입니다. Nanocoder 자체 battlemap은 네이티브 함수 호출, XML 폴백, JSON 폴백이라는 세 가지 도구 호출 경로와 두 폴백 모두에 대한 복구 기능을 제공하므로 소형 및 구형 모델도 계속 사용할 수 있다고 주장합니다. 하지만 이는 관리자의 주장일 뿐 성공률은 게시하지 않습니다. 모델 트레이드오프를 더 폭넓게 보려면 코딩 모델 비교를 참조하세요.

로컬과 원격: 서로 다른 두 가지 예산

로컬 우선 사용자는 청구액이 더 적은 유료 API 구매자가 아니며, 이 둘을 같은 것으로 취급하면 양쪽 모두에서 잘못된 조언을 하게 됩니다. Nanocoder 자체의 배틀맵에는 "Nanocoder를 로컬 모델에 연결해 실행하면 전체 루프가 아웃바운드 네트워크 트래픽 없이 실행될 수 있다"고 명시되어 있으며, Ollama, llama.cpp, llama-swap, LM Studio, LocalAI, MLX Server, vLLM의 7개 로컬 서버가 일급 공급자로 문서화되어 있습니다. 이는 이 프로젝트의 포지셔닝 주장이지, 여기서 측정한 결과가 아닙니다.

로컬 비용에 관해 정직하게 말할 수 있는 것은 아무도 이를 발표하지 않았다는 점입니다. Nanocoder는 하드웨어 요구 사항을 정량화하지 않으므로, 자본 비용과 전기 요금은 직접 산정해야 합니다. 두 가지 동작 때문에 이러한 차이가 숨겨지지 않고 드러납니다. 로컬 및 무료 모델에서는 비용 구간이 생략되며, 헤드리스 실행에서는 공급자가 토큰 텔레메트리를 보고하지 않을 때 usage 블록이 "완전히 생략됩니다(로컬 모델에서 흔함). 따라서 블록이 없다는 것은 '0'이 아니라 항상 '알 수 없음'을 의미합니다".

진입 과정에서 주의할 점이 하나 있습니다. Ollama의 가격 페이지에는 "자체 하드웨어에서 모델을 실행하는 것은 항상 무제한"이라고 명시되어 있으며, Nanocoder의 Ollama 공급자 문서는 키가 필요 없는 로컬 엔드포인트만 다룹니다. 하지만 같은 페이지에서는 호스팅 요금제도 판매합니다. Pro는 월 $20에 월간 사용 크레딧 $60, Max는 $100에 $300, Team은 $500에 공유 $1,000이며, 맞춤형 Enterprise 등급도 있습니다(2026년 9월 21일 확인). 따라서 "Ollama는 무료다"라는 말은 로컬 경로에는 참이지만 호스팅 경로에는 거짓입니다. 두 경로 사이를 이동할 때 Kunavo의 Ollama 호환 엔드포인트 문서에서 해당 API의 형태를 확인할 수 있습니다.

게이트웨이 자금 충전 수수료에 관해 한 가지 주의할 점이 있습니다. 사람들이 놓치기 쉬운 부분이기 때문입니다. OpenRouter의 FAQ에는 "추론 가격에 마크업이 없다"고 명시되어 있으며, 대신 "크레딧을 구매할 때" 수수료를 부과하고, 요금제에 따라 정해진 허용량을 초과하는 BYOK 사용에도 추가 수수료를 부과한다고 설명합니다. 이러한 비율은 결제 수단과 요금제에 따라 달라지고 페이지가 렌더링될 때 채워지므로 여기에서는 어떤 수치도 인용하지 않습니다. 현재 수치는 직접 결제 과정에서 확인하세요. OpenRouter 대안 및 OpenAI 호환 API에서 보다 일반적인 비교를 다룹니다.

토큰 측 비용 책정

위 표의 카탈로그 열은 예산 책정에 사용할 추정치이며, 측정된 작업 비용이나 청구액 상한이 아니라 예시적인 토큰 산술입니다. 가정은 실시간 카탈로그 요금으로 200,000개의 캐시되지 않은 입력 토큰과 15,000개의 출력 토큰을 사용하는 세션 하나이며, 캐시 읽기와 도구 요금은 포함하지 않습니다. 실제 세션은 저장소 크기, 에이전트가 파일을 다시 읽는 빈도, 도구 출력이 컨텍스트로 되돌아오는 양에 따라 달라지며, 위의 도구 프로필은 이 모든 요소가 적용되기 전부터 턴당 오버헤드를 변경합니다.

예산으로 간주하기 전에 하루의 실제 세션 수를 곱하세요. 이러한 가정에서 Claude Haiku 4.5 모델은 크레딧 $10당 약 51 세션을, Claude Opus 5 모델은 약 10 세션을 처리하며, 이는 어떤 모델이 작업을 완료하는지는 알려주지 않고 지갑 규모만 산정합니다. 나열된 최저 요금과 작업 완료에 드는 최저 비용은 서로 다른 주장입니다. 세 번의 시도가 필요한 저렴한 모델은 한 번에 완료하는 모델보다 비용이 더 들 수 있습니다. AI 비용 최적화에서 이 방법을 제대로 다룹니다.

Kunavo의 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림이 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 적용 가능한 마크업을 곱한 금액 중 더 큰 값이 됩니다. 캐시 요금과 외부 도구는 이 예시에서 제외됩니다. 최소 충전액은 선불 크레딧 10달러이며, 이는 자금 충전 최소액이지 작업 요금이나 구독료가 아닙니다.

Nanocoder를 사용자 지정 엔드포인트에 연결하기

모든 OpenAI 호환 서비스는 사용자 지정 공급자로 추가할 수 있습니다. 대화형으로는 /settings providers를 사용하고, 구성 파일에서는 agents.config.json을 사용합니다. 조회 순서는 먼저 프로젝트 파일, 그다음 OS별 사용자 구성 디렉터리이며, NANOCODER_CONFIG_DIR는 두 조회를 모두 건너뛰고 NANOCODER_PROVIDERS 환경 변수가 모든 설정 중 가장 높은 우선순위를 가집니다.

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-4-6"],
        "contextWindow": 1000000
      }
    ]
  }
}

이 블록에 관한 세 가지 참고 사항은 모두 v1.30.0 공급자 문서에서 가져온 것입니다. sdkProvider는 기본값이 openai-compatible이므로 생략되며, 해당 버전의 sdkProvider 옵션 표에 있는 다른 값은 google, anthropic, github-copilot이고, chatgpt-codex는 해당 표가 아니라 자체 공급자 페이지에 문서화되어 있습니다. 키와 기타 구성 값은 $VAR, ${VAR}, ${VAR:-default} 치환을 지원합니다. 또한 requestTimeout의 기본값은 120,000ms이며 -1로 비활성화할 수 있습니다. 이는 호스팅 모델보다 느린 로컬 모델에서 훨씬 더 중요합니다.

컨텍스트 창은 누락할 경우 비용이 발생할 가능성이 가장 큰 부분입니다. Nanocoder는 문서화된 6단계 순서로 모델의 컨텍스트 한도를 확인합니다. 먼저 /context-max 또는 --context-max 세션 재정의, 다음으로 contextWindows[model], 그다음 contextWindow, 이어서 NANOCODER_CONTEXT_LIMIT, 그 후 models.dev 메타데이터, 마지막으로 내장 Ollama 폴백 맵을 확인합니다. Kunavo는 models.dev에 없으므로 마지막 두 단계는 도움이 되지 않으며, 앞의 네 단계 중 하나를 수동으로 설정해야 합니다. 위 값은 이 모델 자체의 Kunavo 카탈로그 항목에서 가져온 것입니다. 이는 단순한 표시용 미터 이상의 의미가 있습니다. 자동 압축은 확인된 컨텍스트 한도의 백분율에서 트리거되며 기본값은 60입니다. 따라서 한도가 잘못되면 에이전트가 컨텍스트를 압축하고 다시 전송하는 빈도가 달라지고, 이는 토큰 비용으로 이어집니다.

첫 실행 전에 알아둘 함정이 하나 더 있습니다. sdkProvider: "anthropic"를 기본 SDK가 Claude 모델로 인식하지 못하는 모델 ID를 제공하는 엔드포인트에 설정하면, 출력 한도가 4096토큰으로 폴백되어 오류 없이 긴 답변이 문장 중간에 잘립니다. 이는 main의 공급자 문서에서 "출력 토큰 한도" 항목 아래에 설명되어 있으며, 한도 자체는 v1.30.0이 이미 의존하는 @ai-sdk/anthropic에서 비롯됩니다. 따라서 문서에는 없더라도 해당 동작은 릴리스된 버전에 존재합니다. 해당 페이지에서 제시하는 수정 방법인 maxOutputTokens도 아직 릴리스되지 않았습니다. v1.30.0에서는 기본 openai-compatible 경로를 유지하는 것이 우회 방법입니다.

Kunavo는 Nanocoder 설정 가이드를 제공하지만, 이는 호환성 테스트가 아니라 구성 참고 자료입니다. Nanocoder는 Kunavo의 엔드포인트에서 런타임 테스트를 거치지 않았으므로, 스트리밍, 도구 호출, 인증, 모델 라우팅은 여기서 엔드 투 엔드로 확인되지 않았습니다. 사용해 보는 동안 작동하는 경로를 유지하고, 범위가 제한된 작업 하나를 실행한 다음, 각주가 아니라 계정에 기록된 실제 청구액을 확인하세요. 키에 자금을 충전할 준비가 되면 Kunavo 계정 만들기를 선택하세요.

경로가 아니라 클라이언트를 비교하려는 경우에는 Nanocoder와 OpenCode에서 이 에이전트를 주류 에이전트와 비교하고, OpenCode 가격에서는 유지 관리자가 토큰을 판매하는 클라이언트를 다루며, 에이전트 API 디렉터리에서는 이 분야의 모든 클라이언트가 사용자 지정 기본 URL을 처리하는 방식을 기록합니다.

자주 묻는 질문

2026년 9월 21일 확인: 게시된 버전, engines 및 라이선스에 대한 npm 레지스트리, 공급자·명령·tune·battlemap 관련 v1.30.0 문서 페이지(누락된 기능의 grep 횟수 포함), 비용 공식과 models.dev 조회를 위한 v1.30.0 변경 로그 및 릴리스된 소스, 배포된 패키지 자체의 비용 포맷터, 공급자 목록과 위에 재현된 요금을 위한 models.dev/api.json, 4096토큰 한도를 확인하기 위해 Nanocoder v1.30.0이 의존하는 @ai-sdk/anthropic의 버전, Ollama의 가격 페이지, Atlas Cloud의 코딩 요금제 페이지, OpenRouter의 FAQ를 확인했습니다. 이 페이지의 대상 검색어에 대한 검색량은 해당 연구에서 측정되지 않았으며, 기반이 된 검색 결과 스냅샷의 날짜는 2026년 9월 17일입니다. Nanocoder는 Kunavo에서 런타임 테스트를 거치지 않았고, 모델 벤치마크도 실행하지 않았으며, 여기의 모든 Kunavo 달러 수치는 측정된 작업 비용이 아니라 실시간 카탈로그를 기반으로 한 예시적인 토큰 산술입니다.