OpenCode 무료 모델 (2026) 및 Free Usage Limit Reached 오류 해결 방법

OpenCode는 별도의 계정 등록 없이도 사용할 수 있는 무료 모델을 지원하는 MIT 라이선스 기반의 무료 도구입니다. 2026년 10월 23일에 모든 무료 모델을 직접 테스트해 보았으나, 첫 번째 요청부터 공개되지 않은 사용량 제한에 걸렸습니다. 모델별 데이터 이용약관, OpenCode에서만 발생하는 403 오류, 10달러짜리 Go 요금제, 그리고 opencode.json에서 모델을 설정하는 방법까지 자세히 다룹니다.

Aiden Flux

Aiden Flux

5 11월 2026

OpenCode 무료 모델 (2026) 및 Free Usage Limit Reached 오류 해결 방법

네, OpenCode는 무료입니다. 이 에이전트는 MIT 라이선스 기반의 오픈소스이며, 공식 홈페이지에도 “OpenCode is 100% free to use(OpenCode는 100% 무료로 사용할 수 있습니다)”라고 명시되어 있습니다. 또한 “계정을 만들지 않고도” 바로 실행할 수 있는 무료 모델들을 기본 제공합니다. 하지만 앱 자체가 아닌 모델 측면에 제약이 있습니다. 제공되는 모든 무료 모델은 한시적으로만 운영되며, OpenCode 내부에서만 동작하고, OpenCode 측에서 공개하지 않은 사용량 한도가 적용되어 있습니다.

OpenCode는 터미널, 데스크톱, IDE를 지원하는 오픈소스 코딩 에이전트로, 75곳 이상의 제공업체에서 제공하는 다양한 모델을 구동할 수 있습니다. 여기에는 OpenCode 자체 콘솔(웹사이트에서 Zen이라고도 부르는 프로바이더)을 통해 제공되는 여러 무료 모델도 포함됩니다.

무료 범위와 유료 결제 기준

구분 비용 제한 사항 초과 시 비용
OpenCode 앱 (CLI, 데스크톱, IDE) $0, MIT 라이선스 앱 자체에는 제한 없음 없음
무료 Console 모델 (opencode/*-free, big-pickle) $0, 로그인 불필요 “한시적 제공”, OpenCode 전용, 비공개 사용량 한도 OpenCode Go 구독 또는 종량제 크레딧
로컬 모델 (Ollama, LM Studio, vLLM) $0 (보유 하드웨어 사용) 로컬 RAM, GPU 사양 및 속도 없음
OpenCode Go 월 $10 (Go Plus는 월 $40) 요금제별 사용량 한도, 1인 전용 워크스페이스 Go Plus로 업그레이드 또는 Console 크레딧 충전
Console 종량제 (Pay-as-you-go) 토큰당 과금 + 크레딧 충전 시 건당 4.6% + $0.31 수수료 잔여 크레딧 및 설정된 예산 한도 추가 크레딧 구매
기존 보유 구독 기존 Claude Pro/Max, ChatGPT Plus/Pro 또는 GitHub Copilot 플랜 해당 플랜의 제한 사항 해당 플랜의 초과 요금 기준 적용

현재 제공되는 무료 모델 목록

2026년 10월 23일 기준으로 OpenCode 모델 안내 페이지(이전 Zen 문서 URL이 이 주소로 리다이렉트됨)에는 아래 모델들이 입력, 출력, 캐시 읽기 비용 모두 $0으로 명시되어 있었습니다. 데이터 취급 약관 역시 동일한 페이지에 명시되어 있으며, 대부분의 사용자가 생각하는 것보다 훨씬 중요한 부분입니다.

모델 (ID) 공식 문서상 데이터 정책
DeepSeek V4.1 Flash Free (deepseek-v4.1-flash-free) 데이터 미보관(Zero retention), 학습 미활용
GLM-5.3-Flash Free (glm-5.3-flash-free) 데이터 미보관(Zero retention), 학습 미활용
LongCat 2.5 Preview Free (longcat-2.5-preview-free) 데이터 미보관(Zero retention), 학습 미활용
Beam Free (beam-free) 학습 미활용, 30일간 보관, 일부 지역 이용 불가
Big Pickle (big-pickle) 비공개 스텔스 모델, 데이터가 “모델 개선에 사용될 수 있음”
Flint 40B Free (flint-40b-free) 모델 개선에 사용될 수 있음, 30일간 보관
Exo Free, MiMo-V2.6-Flash Free, MiMo-V2.5 Free 모델 개선에 사용될 수 있음
Nemotron 3 Ultra Free, Nemotron 3.5 Lightning Free, Nemotron 3.5 Super VL Free NVIDIA 트라이얼 엔드포인트: “개인정보나 기밀 데이터를 입력하지 마십시오”; 사용 내역 로깅됨

목록에는 Jev 1.13 Free도 포함되어 있지만, 이는 코딩 모델이 아닌 구조화된 의사결정용 모델이므로 본 순위에서는 제외했습니다.

공식 문서에서 알려주지 않는 두 가지 핵심적인 내용이 있습니다. 첫째, CLI 내부 카탈로그와 웹 문서의 내용이 일치하지 않습니다. 1.19.4 버전에서 opencode models opencode 명령어를 실행해 보면, 문서에는 이미 빠져 있는 minimax-m3.1-flash-free가 표시되는 반면, Exo, LongCat, MiMo-V2.5는 나타나지 않았습니다. 이 세 모델과 목록에 있던 MiniMax 모델을 선택해 실행하면 즉시 UnknownError가 발생하며 실패했습니다. 둘째, 웹페이지에는 모든 모델이 “OpenCode에서 한시적으로 무료(free on OpenCode for a limited time)”로 제공된다고 적혀 있을 뿐 구체적인 종료일이 명시되어 있지 않습니다. 따라서 이 목록은 특정 시점의 스냅샷 정도로 보아야 합니다.

2026년 10월 23일 진행한 테스트 내용

우리는 npx -y opencode-ai@latest 명령어를 통해 OpenCode 1.19.4 버전을 설치(계정 생성, API 키 등록, auth.json 생성 없이 진행)한 뒤, 각 무료 모델에 대해 각각 독립된 빈 디렉터리에서 동일한 작업을 전달했습니다.

npx -y opencode-ai@latest run --auto --model opencode/deepseek-v4.1-flash-free \
  "Write fizzbuzz.py with a function fizzbuzz(n) ... Write test_fizzbuzz.py with unittest tests for it. Then run: python3 -m unittest test_fizzbuzz -v and report the result."

각 실행에는 4분의 제한 시간을 두었으며, 생성된 파일을 검증하기 위해 테스트 완료 후 직접 테스트를 다시 실행해 보았습니다.

하지만 결과는 예상과 전혀 달랐습니다. 모든 모델에서 첫 번째 요청부터 동일한 오류가 반환되었습니다.

Free usage limit reached. Subscribe to OpenCode Go to keep going: https://opencode.ai/go

이 현상은 DeepSeek V4.1 Flash Free, GLM-5.3-Flash Free, Beam Free, Big Pickle, Flint 40B Free, MiMo-V2.6-Flash Free 및 Nemotron 모델 3종 모두에서 동일하게 발생했습니다. 약 10분 후 순차적으로 다시 시도했으나 결과는 마찬가지였습니다. 어떤 파일도 작성되지 않았고, 테스트도 실행되지 않았습니다. OpenCode는 세 번 재시도한 뒤 제한 시간에 걸려 강제 종료될 때까지 아무런 출력 없이 멈춰 있었기 때문에, 스크립트 환경에서는 --print-logs 옵션을 주지 않으면 마치 프로세스가 먹통(hang)이 된 것처럼 보입니다.

이 사용량 한도는 모델 간에 공유됩니다. 즉, 다른 무료 모델로 바꾼다고 해서 해결되지 않았습니다. 심지어 해당 세션의 맨 첫 번째 요청에서부터 한도 초과가 떴으므로, 우리가 실행한 작업 때문에 한도가 소진된 것도 아니었습니다. 이 한도가 네트워크 단위인지, 디바이스 단위인지, 아니면 전체 글로벌 단위로 집계되는지 확인할 수 없었으며, OpenCode 공식 문서에도 구체적인 한도 수치나 초기화 주기가 명시되어 있지 않습니다.

이는 특정 날짜에 하나의 네트워크에서 진행한 단일 소규모 테스트일 뿐입니다. 전체적인 벤치마크도 아니며, 모델 자체의 성능을 대변하지도 않습니다. 하지만 무료 티어의 치명적인 특성을 명확히 보여줍니다. 정작 필요할 때 아무런 예고 없이 서비스를 이용하지 못할 수 있다는 점입니다.

이와 대조적으로, 앞서 2026년 10월 16일에 진행한 테스트에서는 OpenCode 1.19.2 버전과 opencode/deepseek-v4.1-flash-free 조합으로 로그인 없이도 코드 작성 및 실행 작업을 32초 만에 완수했습니다.

무료 모델 추천 순위

오늘 테스트에서는 어떤 모델도 작업을 끝마치지 못했기 때문에, 금일 실행 결과를 바탕으로 속도나 테스트 통과율 순위를 매길 수는 없습니다. 대신 현재 CLI에서 실제로 추론 단계까지 진입하는지 여부, 과거에 작업을 성공적으로 완수한 이력이 있는지, 그리고 여러분의 코드가 어떻게 취급되는지와 같이 객관적으로 검증 가능한 요소를 기준으로 순위를 정리했습니다.

  1. DeepSeek V4.1 Flash Free: 데이터 보관 없음(Zero retention), 학습 미활용, 1.19.4 카탈로그에 정상 포함됨. 자체 기록상 코드 작성 및 실행 작업을 끝까지 완료한 유일한 무료 모델(10월 16일 테스트 시 32초 기록). 단, 금일 테스트에서는 공유 한도 제한에 걸림.
  2. GLM-5.3-Flash Free: 데이터 보관 없음, 학습 미활용, 카탈로그에 정상 포함됨. 금일 테스트에서는 공유 한도로 인해 차단되었으며, 자체 기록상 완료 이력은 없음.
  3. Beam Free: 학습 미활용. 단, 데이터를 30일간 보관하며 지역 제한이 있음. 금일 테스트에서는 차단됨.
  4. Big Pickle, Flint 40B Free, MiMo-V2.6-Flash Free: 카탈로그에 포함되어 있으나, 공식 문서에 데이터가 모델 개선에 활용될 수 있다고 명시됨. 공개되어도 상관없는 코드 작업에만 사용할 것을 권장.
  5. Nemotron 무료 엔드포인트: NVIDIA 공식 트라이얼 약관에 개인정보나 기밀 데이터를 전송하지 말라고 명시되어 있음. 단순 토이 프로젝트나 연습용 작업에 적합.
  6. LongCat 2.5 Preview Free, Exo Free, MiMo-V2.5 Free, MiniMax M3.1 Flash Free: 요청을 보내기도 전에 모두 UnknownError로 실패함. 앞의 세 모델은 1.19.4 카탈로그에서 누락되어 있고, MiniMax는 공식 문서에서 누락되어 있음. 추후 CLI 카탈로그가 업데이트된다면, 데이터 보관 정책이 없는 LongCat의 순위가 크게 올라갈 것으로 보임.

기억해야 할 단 하나의 규칙이 있다면 다음과 같습니다. 비공개 사내 코드나 중요 프로젝트에는 반드시 문서상 'Zero retention(데이터 미보관)'으로 명시된 모델을 선택하세요.

무료 티어의 한계와 주의점

OpenCode 내부에서만 사용 가능: 이 부분은 금일 다시 검증했습니다. https://opencode.ai/inference/openai/v1/chat/completions 엔드포인트로 deepseek-v4.1-flash-free를 직접 호출하면 HTTP 403 오류와 함께 FreeTierError(“OpenCode's free tier can only be used from within OpenCode”)가 반환됩니다. 즉, 무료 모델은 외부에서 호출할 수 있는 무료 API가 아닙니다. 코드에서 직접 호출할 수 있는 API 키가 필요하다면 무료 AI API 키 안내를 확인하세요.

한시적 제공: 모든 무료 항목에는 '한시적 제공'이라는 문구가 붙어 있습니다. 모델 라인업은 사전 공지 없이 수시로 교체될 수 있습니다.

비공개 사용량 한도: 앞서 언급한 바와 같이, 한도에 도달하면 OpenCode Go 구독을 안내하는 에러 메시지가 출력됩니다.

무료 모델 비활성화 옵션: 팀 환경에서 무료 모델 사용을 완전히 차단해야 하는 경우, 공식 문서에 따라 OPENCODE_DISABLE_FREE_MODELS=1 환경 변수를 설정하면 됩니다. 설정 시 무료 모델이 목록에서 사라지며, 무료 모델을 선택하려고 하면 “Model unavailable” 오류가 발생합니다.

가장 저렴한 유료 대안

에러 메시지에서도 안내하듯 가장 빠른 유료 전환 옵션은 월 $10의 OpenCode Go나 한도가 더 높은 월 $40의 Go Plus입니다. Go 플랜은 GLM-5.3-Flash, DeepSeek V4.1 Flash, MiniMax M3.1 Flash를 포함한 엄선된 모델 풀을 제공하며, 1인 전용 워크스페이스로 제한되고 가입 여부는 전적으로 사용자의 선택입니다.

또 다른 대안은 종량제(Pay-as-you-go) 결제입니다. Console 요금표 기준 DeepSeek V4.1 Flash는 입력 토큰 100만 개당 $0.30, 출력 토큰 100만 개당 $1.20이며, GLM 5.3 Flash는 각각 $0.15 및 $0.50입니다. 다만 토큰당 단가가 저렴하다고 해서 전체 작업 비용까지 무조건 저렴한 것은 아닙니다. 자세한 이유는 저렴한 모델이 오히려 더 많은 비용을 초래하는 이유에서 확인할 수 있습니다.

opencode.json에서 무료 모델 설정하는 방법

프로젝트 디렉터리나 ~/.config/opencode/ 경로의 opencode.json(또는 opencode.jsonc) 파일에 공식 문서에 나온 opencode/<model-id> 형식으로 모델을 지정하면 됩니다.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/deepseek-v4.1-flash-free"
}

설정하기 전에 먼저 opencode models opencode 명령어를 실행하여 현재 설치된 버전에서 해당 모델 ID가 지원되는지 확인하세요. 단발성 실행 시에는 opencode run --model opencode/glm-5.3-flash-free "..."와 같이 기본 설정을 덮어쓸 수 있습니다. 공유 한도 걱정 없이 진정한 의미의 완전 무료($0) 환경을 원한다면 "model": "ollama/gemma3:4b"와 같이 로컬 모델을 지정하면 됩니다. OpenCode는 Ollama, LM Studio, vLLM의 기본 로컬 주소를 자동으로 감지합니다.

OpenCode와 다른 유료 에이전트 간의 비교를 고민 중이라면, Claude Code는 무료인가요? 포스팅에서 비교 분석 내용을 확인해 보세요.

Sharkly와의 연계 활용

이미 코딩 에이전트를 사용하고 계신가요? Sharkly는 이 에이전트들을 하나의 팀으로 유기적으로 연결해 줍니다. 이미 보유한 OpenCode, Claude Code, Codex 등을 자체 컴퓨터에 할당 가능한 Agent로 등록하고, 격리된 worktree에서 각 Task를 실행한 뒤 그 결과를 다시 해당 Task로 전달받을 수 있습니다.

Sharkly가 모델 자체를 무료로 만들어 주거나 OpenCode의 한도를 변경해 주는 것은 아닙니다. Agent는 해당 Runtime의 기본 모델 설정을 따르므로, OpenCode Agent는 해당 컴퓨터의 opencode.json에 설정된 model(무료 한도 포함)을 그대로 사용합니다. Sharkly 요금 안내 페이지에 따르면 Free 플랜은 최대 5인 조직까지 무료로 지원되며, 이후 Team 플랜은 연간 청구 시 인당 월 $7입니다. 또한 “게스트, Agent 및 컴퓨터는 시트(seat) 수를 차지하지 않으며”, “Sharkly는 별도로 토큰을 판매하지 않습니다.” 자세한 OpenCode 연동 방식은 DeepSeek V4.1 Flash 가이드를 참고하세요.

여러 에이전트를 함께 운용 중이라면, Sharkly에 연결하여 각 에이전트의 기존 모델 설정을 그대로 유지하면서 편리하게 관리해 보세요.

자주 묻는 질문 (FAQ)

OpenCode는 정말 무료인가요? 네. 앱 자체는 MIT 라이선스이며 “100% 무료”로 이용할 수 있습니다. 별도 계정 등록 없이 쓸 수 있는 무료 모델도 포함되어 있습니다. 유료 프로바이더를 연결하거나 Go 요금제를 구독하거나, Console 크레딧을 구매할 때만 비용이 발생합니다.

OpenCode에서 제공하는 무료 모델에는 무엇이 있나요? 2026년 10월 23일 기준 공식 문서에는 DeepSeek V4.1 Flash Free, GLM-5.3-Flash Free, LongCat 2.5 Preview Free, Beam Free, Big Pickle, Flint 40B Free, Exo Free, MiMo 모델 2종, Nemotron 모델 3종이 등재되어 있으며 모두 “한시적 제공” 조건입니다. 현재 설치된 버전에서 실제 선택 가능한 모델은 opencode models opencode 명령어로 확인할 수 있습니다.

코딩용으로 가장 추천하는 OpenCode 무료 모델은 무엇인가요? 비공개 소스코드 기준으로는 데이터 미보관(Zero retention) 정책을 적용하는 DeepSeek V4.1 Flash Free 또는 GLM-5.3-Flash Free를 권장합니다. 실제 작업 완료를 검증한 모델은 DeepSeek이 유일합니다. 단, 10월 23일 테스트 시점에는 무료 사용량 한도로 인해 모든 모델의 작업이 완료되지 못했습니다.

“Free usage limit reached” 오류는 무슨 뜻인가요? OpenCode의 무료 티어 전체 한도에 도달했다는 의미이며, 이 한도는 모든 무료 모델에 공통 적용됩니다. 구체적인 한도 크기나 갱신 시점은 공개되어 있지 않습니다. 일정 시간 대기하거나, 로컬 모델로 전환하거나, OpenCode Go로 전환해야 합니다.

자체 작성 코드에서 OpenCode 무료 모델을 직접 호출할 수 있나요? 불가능합니다. 직접 API를 호출하면 HTTP 403 FreeTierError가 발생합니다. 무료 티어는 오직 OpenCode 앱 내부에서만 동작하도록 제한되어 있습니다.

OpenCode 무료 모델이 내 코드를 학습에 활용하나요? 일부 모델은 활용할 수 있습니다. 공식 문서 기준으로 DeepSeek, GLM-5.3-Flash, LongCat은 데이터 미보관(학습 미활용)으로 표기되어 있으나, Big Pickle, Flint, Exo, MiMo는 “모델 개선에 사용될 수 있음”으로 명시되어 있고 Nemotron 엔드포인트는 사용 로그를 기록합니다.

더 둘러보기

GPT-6 Cyber가 AI 에이전트 운영팀에 미치는 영향과 시사점

GPT-6 Cyber가 AI 에이전트 운영팀에 미치는 영향과 시사점

GPT-6 Cyber를 사용하려면 Daybreak Red와 모델 승인이 필요하며, 비용은 입력 토큰 100만 개당 20달러입니다. AI 에이전트 팀이 보안 검토와 트리아지를 어떻게 라우팅해야 하는지 그 방법을 소개합니다.

6 11월 2026

Gemini Omni 1.2 Flash 요금제 분석: 초당 0.07달러, 팀 단위 도입 시 실제 비용은?

Gemini Omni 1.2 Flash 요금제 분석: 초당 0.07달러, 팀 단위 도입 시 실제 비용은?

Gemini Omni 1.2 Flash 요금은 720p 기준 초당 0.07달러부터 시작하지만, 팀의 경우 시도 횟수당 비용이 청구됩니다. 해상도별 전체 요율과 바로 활용할 수 있는 월간 예산안을 확인해 보세요.

6 11월 2026

Gemini Omni 1.2 Flash는 무료일까?

Gemini Omni 1.2 Flash는 무료일까?

Gemini Omni 1.2 Flash는 Gemini API에서 무료 티어를 제공하지 않으며, 300달러의 Google Cloud 크레딧 역시 Gemini API에는 적용되지 않습니다. 0달러로 비디오를 생성할 수 있는 플랫폼(Google Vids 및 Flow), 각 플랫폼별 한도와 클립당 비용, 그리고 에이전트가 직접 호출할 때 이것이 무엇을 의미하는지 살펴봅니다.

6 11월 2026