2026년 10월 15일, OpenCode는 X에 게시했습니다: "DeepSeek V4.1 Flash가 이제 OpenCode에서 무료입니다." 모델 ID는 opencode/deepseek-v4.1-flash-free이며, OpenCode Zen 문서에는 "OpenCode에서 제한된 시간 동안 무료"라고 나와 있습니다. 우리는 10월 16일에 OpenCode의 깨끗한 사본을 설치하고, 로그인도 API 키도 없이 이 모델을 선택했으며, 32초 만에 작은 Node.js 스크립트를 작성하고 실행하는 것을 지켜보았습니다.
이 혜택에는 세 가지 제약이 따릅니다. 무료 모델은 API가 아니라 OpenCode 앱 내에서만 작동합니다. 컨텍스트는 200K 토큰으로 제한되는데, 유료 버전은 1M을 지원합니다. 그리고 OpenCode는 종료 날짜를 공개하지 않았습니다. 이 가이드에서는 설정, 각 제약이 여러분의 작업에 무엇을 의미하는지, 그리고 같은 모델을 여러분의 코드에서 필요로 할 때 드는 비용을 다룹니다. 모델 자체에 대한 배경 지식은 DeepSeek V4.1 Flash란 무엇인가를 읽어보세요. 그 코드가 API를 호출한다면, Apidog CLI를 통해 동일한 에이전트가 터미널에서 이를 테스트할 수 있습니다.
OpenCode가 제공하는 것
DeepSeek V4.1 Flash는 2026년 9월 10일 MIT 라이선스 가중치와 함께 DeepSeek의 API에서 정식 출시(GA)되었습니다. OpenCode는 자체 모델 게이트웨이인 OpenCode Zen을 통해 무료 버전과 유료 버전으로 이 모델을 제공합니다. 다음은 동일한 모델에 대한 다른 유료 경로와의 비교입니다:
| 경로 | 가격 | 컨텍스트 / 최대 출력 | 작동 위치 |
|---|---|---|---|
OpenCode, deepseek-v4.1-flash-free |
제한된 시간 동안 $0 | 200K / 32K 토큰 | OpenCode 내에서만 |
OpenCode Zen, deepseek-v4.1-flash |
1M 토큰당 입력 $0.30 / 출력 $1.20 | 1M / 384K | Zen API 키가 있는 모든 클라이언트 |
| OpenCode Go 플랜 | 월 $10; 이 모델에 대한 월 $80 사용 한도 | 1M / 384K | OpenCode 내에서 |
DeepSeek API, deepseek-flash |
비피크 시간대 1M 토큰당 입력 $0.15 / 출력 $0.60 | 1M / 384K | 모든 클라이언트 |
컨텍스트와 출력 제한은 OpenCode가 제공하는 모델 메타데이터에서 비롯되며, opencode models opencode --verbose로 출력할 수 있습니다. 가격은 Zen 문서, OpenCode Go 문서, 그리고 DeepSeek의 가격 페이지에서 10월 16일에 확인한 내용입니다.
OpenCode에서 DeepSeek V4.1 Flash를 무료로 사용하는 방법
이 도구가 처음이신가요? 우리의 OpenCode 개요에서 이 에이전트가 무엇을 하는지 다룹니다. 설정은 세 단계로 이루어집니다.
1. OpenCode 설치
공식 설치 스크립트는 macOS와 Linux에서 작동합니다:
curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai 또는 brew install anomalyco/tap/opencode를 사용할 수도 있습니다. Windows에서는 OpenCode가 WSL을 권장하며, Chocolatey(choco install opencode)와 Scoop(scoop install opencode) 패키지도 존재합니다.
2. 무료 모델 선택
프로젝트를 열고 에이전트를 시작하세요:
cd ~/code/orders-service
opencode
/models를 입력하고 DeepSeek V4.1 Flash Free를 선택하세요. 프로젝트의 기본값으로 설정하려면 프로젝트 루트에 opencode.json 파일을 추가하세요:
{
"$schema": "https://opencode.ai/config.json",
"model": "opencode/deepseek-v4.1-flash-free"
}
3. 작업 실행
대화형 세션에서 작업하거나, 셸에서 일회성 작업을 보내세요:
opencode run -m opencode/deepseek-v4.1-flash-free \
"Create status.js exporting isClientError(code) for 4xx codes, add a node:assert self-test, then run it"
우리 테스트에서 나타난 결과
우리는 10월 16일에 opencode-ai npm 릴리스인 OpenCode 1.19.2를 빈 설정 및 데이터 디렉터리로 실행했습니다. opencode models opencode는 열 개의 무료 모델 중에서 deepseek-v4.1-flash-free를 나열했습니다. 한 줄짜리 질문은 5초 만에 돌아왔습니다. 위 작업은 32초가 걸렸습니다: 모델이 status.js를 작성하고, node로 실행하고, all tests passed를 보고했습니다. 파일 쓰기와 셸 도구 모두 작동했습니다.
로그인을 요구하는 것은 아무것도 없었습니다. Zen 문서에는 Console에 로그인하고, 결제를 추가하고, API 키를 복사하는 방법이 설명되어 있지만, 그 단계는 Zen의 유료 모델에 해당합니다. 무료 모델은 그런 것 없이 실행되었습니다.
OpenCode의 메타데이터에는 이 모델에 대한 세 가지 추론 강도 변형(low, high, max)이 나열되어 있고 이미지 입력이 활성화되어 있어, 실패하는 UI의 스크린샷을 첨부할 수 있습니다. PDF 입력은 비활성화되어 있습니다.
"무료" 뒤에 숨은 제약
OpenCode 내에서만 작동합니다
Zen 문서는 무료 모델을 OpenAI 호환 엔드포인트 옆에 나열하는데, 이 때문에 무료 API처럼 보입니다. 하지만 그렇지 않습니다. OpenCode가 아닌 다른 곳에서 호출하면 게이트웨이가 거부합니다:
curl https://opencode.ai/inference/openai/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash-free", "messages": [{"role": "user", "content": "ping"}]}'
{"type":"error","error":{"type":"FreeTierError","message":"OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building."}}
우리는 10월 16일에 Authorization 헤더가 있을 때와 없을 때 모두 HTTP 403을 받았습니다. 따라서 무료 등급은 OpenCode에서의 코딩을 대상으로 합니다. 여러분 앱의 백엔드, LLM을 호출하는 여러분 자신의 스크립트, 그리고 Cursor나 Claude Code 같은 다른 에이전트는 이를 사용할 수 없습니다.
일부 커뮤니티 플러그인은 다른 도구의 요청을 로컬 opencode serve 프로세스를 통해 라우팅하여 요청이 OpenCode에서 오는 것처럼 만듭니다. 이들은 OpenCode가 문서화하지 않은 동작에 의존하며, 게이트웨이 검사는 어느 릴리스에서든 바뀔 수 있습니다.
컨텍스트는 1M이 아니라 200K입니다
유료 모델은 1M 토큰의 컨텍스트를 받아들이고 최대 384K를 반환합니다. 무료 모델은 입력 200K, 출력 32K에서 멈춥니다. 200K는 대부분의 코딩 세션을 커버합니다. 대규모 모노레포나 많은 파일을 읽는 긴 세션에서는 더 빨리 소진되며, 32K는 한 응답이 생성할 수 있는 코드 양을 제한합니다. 작업에 전체 윈도우가 필요할 때는 /models로 해당 세션을 유료 모델로 전환하세요.
종료 날짜 없이 제한된 시간 동안 무료입니다
OpenCode는 이전에도 이런 종류의 프로모션을 진행한 적이 있습니다. 이전의 deepseek-v4-flash-free 모델은 프로모션이 끝날 때까지 Zen의 무료 목록에 있었습니다. 2026년 8월 21일까지 그것은 모델 선택기에서 사라졌고, OpenCode 봇이 GitHub 이슈 #43805에서 제거가 버그가 아니라 의도적인 것임을 확인했습니다.
여기서도 같은 결말을 예상하세요. 모델 이름을 스크립트가 아니라 opencode.json에 유지하여, 유료 모델로 이동하는 것이 한 줄 수정이 되도록 하세요.
개인정보 보호는 대부분의 무료 옵션보다 낫습니다
OpenCode 목록의 무료 모델들이 모두 여러분의 코드를 같은 방식으로 취급하지는 않습니다. DeepSeek V4.1 Flash Free의 경우, Zen 문서에 따르면 제공업체가 "제로 리텐션 정책을 따르며 여러분의 데이터를 모델 학습에 사용하지 않습니다."
그곳의 모든 무료 모델이 그런 것은 아닙니다. Big Pickle과 MiMo 모델은 수집된 데이터가 "모델 개선에 사용될 수 있다"고 명시하며, NVIDIA의 Nemotron 체험판은 개인적이거나 기밀인 데이터를 제출하지 말라고 알려줍니다. 비공개 저장소의 경우 DeepSeek 모델은 더 안전한 무료 선택 중 하나입니다. OpenCode는 모든 Zen 모델이 미국과 EU에서 호스팅된다고 밝히고 있습니다.
공개된 요청 제한 없음
Zen 문서도 Console 문서도 무료 모델에 대한 요청 제한을 명시하지 않습니다. OpenCode는 무료 엔드포인트가 유료 엔드포인트의 속도나 가용성을 따라잡을 것이라고 약속하지 않으므로, 수요가 급증할 때 느려질 것을 예상하세요.
API가 필요할 때 같은 모델의 비용
모델이 여러분의 제품 내에서 실행되어야 할 때는 유료 경로를 선택하세요. DeepSeek 자체 API가 토큰당 가장 저렴합니다: 비피크 시간대에 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.60입니다. 피크 시간대(월요일~금요일, UTC 01:00~04:00 및 06:00~10:00)에는 둘 다 두 배가 되며, 캐시 적중은 비피크 시간대에 1M당 $0.003입니다. Zen의 유료 deepseek-v4.1-flash는 DeepSeek의 피크 요금과 동일한 $0.30과 $1.20을 정액으로 부과하며, Zen 키 하나로 게이트웨이의 모든 모델에 접근할 수 있습니다.
20,000 입력 토큰과 2,000 출력 토큰을 사용하는 에이전트 턴의 계산은 다음과 같습니다:
- DeepSeek API, 비피크: 0.02 x $0.15 + 0.002 x $0.60 = $0.0042
- OpenCode Zen, 유료: 0.02 x $0.30 + 0.002 x $1.20 = $0.0084
이런 턴이 천 번이면 캐시 할인 전에 $4.20 또는 $8.40이 듭니다. 매일 OpenCode에서 코딩하고 무료 프로모션이 끝난다면, Go 플랜이 중간 옵션입니다: 월 $10, 이 모델에 대한 월 $80 사용 한도, 그리고 OpenCode의 추정으로 월 약 173,330건의 요청입니다.
피크와 캐시 계산에 대한 자세한 내용은 DeepSeek V4.1 Flash 가격 가이드를 참조하세요. 여러 언어의 요청 코드는 DeepSeek V4.1 Flash API 사용 방법을 참조하세요.
Apidog CLI로 OpenCode가 API를 테스트하게 하세요
무료 모델은 코드를 작성하는 것 이상을 할 수 있습니다. 같은 터미널에서 코드가 호출하는 엔드포인트를 테스트할 수 있어, 아무도 Send를 클릭하려고 GUI를 열 필요가 없습니다. Apidog CLI는 API 명세를 읽고, 테스트 케이스를 작성하고, 실행할 수 있는 명령을 제공합니다. 한 번 설정하세요:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
토큰은 Apidog의 계정 설정, API 액세스 토큰에서 가져옵니다. 마지막 줄은 Apidog의 에이전트 스킬을 설치하며, 이는 OpenCode가 CLI를 구동하는 방법을 가르칩니다. 그런 다음 에이전트에게 하나의 프롬프트를 주세요:
Use Apidog CLI on project <id>. Export the /orders endpoints as OpenAPI and write a
typed TypeScript client from them. Then create a test case for POST /orders that
asserts a 201 and an order id, run it against the dev environment, and summarize
any failures.
다음은 Apidog CLI 2.2.7에서 확인한, 에이전트가 실행하는 명령입니다:
apidog export --project <id> --format openapi --output ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json
명세를 먼저 내보내면 클라이언트가 모델이 추측한 필드 이름이 아니라 여러분 팀이 설계한 API와 일치합니다. 모든 명령은 JSON을 반환하며, 다수는 agentHints.nextSteps를 포함하므로 에이전트는 다음에 무엇을 실행할지 알 수 있습니다. CLI가 메인 브랜치에서 쓰기를 거부하면, 앱의 AI 기능 설정에서 External AI Edit Permissions를 활성화하거나, 에이전트가 AI 브랜치에서 작업하도록 하세요(apidog branch create --project <id> --type ai --name ai/orders-tests --from main). 동일한 apidog run 줄에 -r junit을 붙이면 CI에 들어갑니다. 우리의 Apidog CLI CI/CD 파이프라인에 복사해서 붙여넣을 수 있는 버전이 있습니다.
FAQ
DeepSeek가 OpenCode에서 무료인가요? 예. DeepSeek V4.1 Flash(opencode/deepseek-v4.1-flash-free)는 2026년 10월 15일부터 OpenCode에서 무료입니다. OpenCode는 이를 제한된 시간 제공이라고 부르며 종료 날짜를 제시하지 않았습니다.
OpenCode 계정이나 API 키가 필요한가요? 우리 테스트에서는 필요하지 않았습니다. 새로 설치한 OpenCode 1.19.2가 무료 모델을 둘 다 없이 실행했습니다. Zen의 유료 모델은 OpenCode Console에서 발급받은 API 키가 필요합니다.
무료 모델을 내 코드에서 호출할 수 있나요? 아니요. OpenCode 외부에서의 요청은 403 FreeTierError를 받습니다. 대신 DeepSeek의 API 또는 Zen의 유료 deepseek-v4.1-flash를 사용하세요.
전체 DeepSeek V4.1 Flash인가요? OpenCode는 이를 유료 모델과 동일한 deepseek-flash 제품군에 나열하지만, 더 낮은 제한을 가집니다: 1M과 384K 대신 200K 컨텍스트와 32K 출력입니다. OpenCode는 다른 점이 있는지 밝히지 않았습니다.
이것을 사용할 때 OpenCode가 내 코드로 학습하나요? Zen 문서에 따르면 이 모델의 제공업체는 데이터를 전혀 보관하지 않고 학습에 사용하지 않습니다. 목록의 다른 무료 모델은 조건이 다르므로 전환하기 전에 확인하세요.
V4.1 Flash를 무료로 사용하는 다른 방법이 있나요? 예: MIT 라이선스 가중치와 DeepSeek의 챗 앱입니다. DeepSeek V4.1 Flash를 무료로 사용하는 모든 방법 가이드에서 순위를 매겼으며, DeepSeek는 무료인가요?에서 전체 모델 라인을 다룹니다.
지속되는 동안 사용하세요
무료 모델은 우리의 파일 및 셸 테스트를 32초 만에 통과했고, OpenCode 내에 있고 200K 토큰 미만인 한 $0입니다. OpenCode를 설치하고, opencode/deepseek-v4.1-flash-free를 모델로 설정하고, Apidog CLI를 추가하여 동일한 에이전트가 자신이 만든 것을 테스트하도록 하세요. 모델 이름을 opencode.json에 유지하면, 프로모션 종료가 설정 변경이 됩니다. Apidog 다운로드로 에이전트가 --upload-report로 업로드한 테스트 보고서를 여세요.