DeepSeek V4.1 Flash 무료로 쓰려면? OpenCode 연결 방법

OpenCode는 프로젝트 파일을 읽고 코드 설명이나 수정을 도와주는 AI 코딩 도구예요. 여기에 **DeepSeek V4.1 Flash Free**를 연결하면 모델 파일을 내려받지 않고도 코드와 질문을 보내 리뷰를 받을 수 있어요. OpenCode가 요청을 준비하면 클라우드에서 실행되는 모델이 답변을 만들어요.

DeepSeek V4.1 Flash는 MIT 라이선스로 가중치가 공개된 모델이에요. 처음부터 큰 모델을 내 장비에 올리기 부담스럽다면 무료 API¹로 답변을 먼저 살펴볼 수 있죠. 이 글에서는 공개해도 되는 짧은 Python 함수 하나의 오류를 찾는 작업으로 시작해요.

2026년 10월 16일 기준 OpenCode는 DeepSeek V4.1 Flash Free의 입력·출력·캐시 읽기를 무료로 제공해요. 모델 선택 화면에서 Free까지 확인하세요. 일반 DeepSeek V4.1 Flash는 별도의 유료 항목으로 함께 표시돼요.

한시 프로모션으로 제공돼요. 종료 날짜나 보장되는 분당·일일 호출량은 공개되지 않았으므로, 장시간 자동 작업보다는 모델을 시험하는 용도로 시작하세요.

처음 설치한다면 터미널에서 node --version과 npm --version을 실행해 Node.js와 npm이 준비돼 있는지 확인하세요. 버전이 표시되면 아래 명령으로 OpenCode V2를 설치하면 돼요. 이미 OpenCode를 쓰고 있다면 V2 설치·이전 안내를 먼저 읽어보세요. 프로젝트는 비공개 저장소 대신 공개 예제 파일을 복사한 별도 폴더로 시작하면 좋아요.

npm install -g @opencode/cli

예제 폴더에서 opencode를 실행하고 /connect를 입력하세요. OpenCode pay-as-you-go 제공자를 선택해 Console에서 발급한 API 키를 연결하세요. 이어서 /models에서 DeepSeek V4.1 Flash Free를 골라요. 계정 화면에서 결제나 충전을 요구하면 무료 이용 조건부터 확인하고, 무료 체험을 위해 바로 결제하지는 마세요.

매번 같은 모델로 시작하려면 프로젝트의 opencode.jsonc에 아래 model 값을 지정할 수 있어요. 기존 설정이 있으면 파일 전체를 덮어쓰지 말고 해당 항목만 합치세요. 새 세션에서도 선택된 모델 이름에 Free가 보이는지 확인하세요.

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

아래 함수를 예제 폴더의 average.py로 저장하세요. 질문을 보내기 전에 /agents에서 Plan을 선택하면 일반 프로젝트 파일을 수정하지 않고 내용을 살펴보는 흐름으로 시작할 수 있어요.

def average(values):
    return sum(values) / len(values)

OpenCode에서 @를 입력해 average.py를 첨부한 뒤 ‘빈 목록이 들어올 때 생기는 문제와 고치는 방법을 설명해줘. 파일 수정과 명령 실행은 하지 마’라고 요청하세요. 명령 실행을 묻는 창이 뜨면 이번 작업에서는 거절하세요. 답변에서는 빈 목록의 길이가 0이라는 점과 0으로 나누는 연산을 짚는지 살펴보세요.

답변이 쓸 만하면 그다음에 수정안을 요청하세요. OpenCode에 실제 수정을 맡길 때는 파일 편집을 허용하는 에이전트로 전환하고 변경 요청을 승인하세요. Git 저장소에서는 git diff로 바뀐 부분을 읽고, 별도로 만든 일반 예제 폴더라면 수정 전후 파일을 직접 비교하면 돼요. 빈 목록과 일반 목록을 넣은 테스트를 각각 실행해 수정 결과도 확인하세요.

Console의 Settings → Billing에서 Auto-recharge 규칙을 확인하고 무료로만 시험할 계정에서는 꺼두세요. OpenCode는 세션 제목 생성에 다른 저가 모델을 사용할 수도 있어요. 사용 내역에서 본문 답변과 부가 요청의 모델 ID·비용을 함께 살펴보세요.

부가 요청을 분리하고 싶다면 아래처럼 무료 모델 API만 직접 호출할 수 있어요. Python 3에서 표준 라이브러리만 사용하고, 키는 실행 중 숨김 입력으로 받아요. 코드를 opencode-free-check.py로 저장해 python3 opencode-free-check.py로 실행하세요. 이 예시는 한 번만 요청하며 자동 재시도나 유료 모델 전환을 하지 않아요.

import getpass
import json
import urllib.request

key = getpass.getpass('OpenCode API key: ')
payload = {
    'model': 'deepseek-v4.1-flash-free',
    'messages': [{'role': 'user', 'content':
        'Review this Python function for empty-list handling:\n'
        'def average(values):\n    return sum(values) / len(values)'}],
    'max_tokens': 2048,
}
request = urllib.request.Request(
    'https://opencode.ai/inference/openai/v1/chat/completions',
    data=json.dumps(payload).encode(),
    headers={'Authorization': 'Bearer ' + key,
             'Content-Type': 'application/json'},
)
with urllib.request.urlopen(request, timeout=120) as response:
    result = json.load(response)
choice = result['choices'][0]
print(choice['message'].get('content') or '(empty content)')
print('finish_reason:', choice.get('finish_reason'))

정상 응답에서는 choices[0].message.content에 리뷰 텍스트가 들어가요. finish_reason이 length이거나 답변이 비어 있다면 출력 한도에서 추론이 끝나지 않았을 수 있으니 짧은 입력으로 다시 시험하세요. 인증 오류는 키와 연결 계정을, 한도 오류는 무료 항목의 제공 상태와 재시도 안내부터 살펴보면 돼요.

DeepSeek 무료 항목의 공급자는 요청 내용을 보관하지 않고 모델 학습에도 쓰지 않는 정책을 안내하고 있어요. 코드는 클라우드로 전송되므로, 처음에는 비밀 키나 고객 정보가 없는 공개 예제를 사용하세요. 같은 무료 목록의 MiMo나 NVIDIA 항목은 데이터 처리 조건이 다르니 모델을 바꿀 때 해당 조건도 읽어보세요.

공개 프로젝트에서 가끔 코드 리뷰를 받는다면 이 무료 경로부터 써볼 만해요. 비공개 자료를 외부로 보낼 수 없거나 호출 한도 없이 내 장비에서 실행하고 싶다면 로컬 에이전트 시작 가이드로 이어가세요. 다른 무료 제공자의 한도와 연결 방식은 무료 오픈웨이트 서비스 비교에 모았어요.