OpenCode Zen

OpenCode Zen의 모델을 Docker Agent에서 사용하는 방법을 설명해요. 검증된 AI 모델의 큐레이션 게이트웨이로, 하나의 API 키로 다양한 모델을 종량제로 쓸 수 있어요.

출처: 문서

본문

OpenCode Zen은 OpenCode 팀이 제공하는, 테스트되고 검증된 AI 모델의 큐레이션 게이트웨이예요. GPT와 Claude부터 오픈소스 모델까지 넓은 범위의 모델에 단일 API 키로 종량제(pay-per-use) 접근을 제공해요. 일부 무료 모델도 있어요. Docker Agent에는 OpenAI 호환 모델용 OpenCode Zen을 기본 제공 alias 프로바이더로 지원하고 있어요. Anthropic과 Google 모델은 커스텀 프로바이더 정의로 지원돼요.

설정

OpenCode Zen에 로그인하고 결제 정보를 추가한 뒤 API 키를 복사하세요.

export OPENCODE_API_KEY=your-api-key

curl https://opencode.ai/zen/v1/models

사용법

인라인 문법

무료 모델로 OpenCode Zen을 쓰는 가장 간단한 방법:

agents:
  root:
    model: opencode-zen/deepseek-v4-flash-free
    description: Assistant using OpenCode Zen (free)
    instruction: You are a helpful assistant.

네임드 모델 (Named Model)

파라미터를 더 세밀하게 제어하려면:

models:
  zen_model:
    provider: opencode-zen
    model: gpt-5.5
    temperature: 0.7
    max_tokens: 16384

agents:
  root:
    model: zen_model
    description: Assistant using OpenCode Zen
    instruction: You are a helpful assistant.

사용 가능한 모델

무료 모델

비용 없이 쓸 수 있는 모델:

모델	설명
`deepseek-v4-flash-free`	무료 DeepSeek V4 Flash
`mimo-v2.5-free`	무료 MiMo V2.5 모델
`qwen3.6-plus-free`	무료 Qwen 3.6 Plus 모델
`minimax-m3-free`	무료 MiniMax M3 모델
`nemotron-3-ultra-free`	무료 Nemotron 3 Ultra 모델
`north-mini-code-free`	무료 North Mini Code 모델
`big-pickle`	무료 스텔스 모델

OpenAI 호환 (Chat Completions)

이 모델들은 /v1/chat/completions 엔드포인트를 사용하고 opencode-zen alias와 직접 동작해요:

모델	설명
`deepseek-v4-pro`	DeepSeek V4 Pro 모델
`deepseek-v4-flash`	빠른 DeepSeek V4 모델
`glm-5.2`	GLM 5.2 모델
`glm-5.1`	GLM 5.1 모델
`glm-5`	GLM 5 모델
`kimi-k2.6`	Kimi K2.6 모델
`kimi-k2.5`	Kimi K2.5 모델
`minimax-m2.7`	MiniMax M2.7 모델
`minimax-m2.5`	MiniMax M2.5 모델
`grok-build-0.1`	Grok Build 0.1 모델

OpenAI 호환 (Responses API)

이 모델들은 /v1/responses 엔드포인트를 사용하고 Docker Agent가 모델 이름으로 자동 감지해요:

모델	설명
`gpt-5.5`	최신 GPT 모델
`gpt-5.5-pro`	GPT 5.5 Pro, 최고 능력
`gpt-5.4`	GPT 5.4 모델
`gpt-5.4-pro`	GPT 5.4 Pro 모델
`gpt-5.4-mini`	GPT 5.4 Mini 모델
`gpt-5.4-nano`	GPT 5.4 Nano, 가장 빠름
`gpt-5.3-codex`	코딩용 GPT 5.3 Codex
`gpt-5.3-codex-spark`	GPT 5.3 Codex Spark
`gpt-5.2`	GPT 5.2 모델
`gpt-5.2-codex`	GPT 5.2 Codex
`gpt-5.1`	GPT 5.1 모델
`gpt-5.1-codex`	GPT 5.1 Codex
`gpt-5.1-codex-max`	GPT 5.1 Codex Max
`gpt-5.1-codex-mini`	GPT 5.1 Codex Mini
`gpt-5`	GPT 5 모델
`gpt-5-codex`	GPT 5 Codex
`gpt-5-nano`	GPT 5 Nano

Anthropic 호환 (Messages API)

이 모델들은 /v1/messages 엔드포인트를 사용하고 커스텀 프로바이더 정의가 필요해요:

모델	설명
`claude-fable-5`	Claude Fable 5 모델
`claude-opus-4-8`	Claude Opus 4.8 모델
`claude-opus-4-7`	Claude Opus 4.7 모델
`claude-opus-4-6`	Claude Opus 4.6 모델
`claude-opus-4-5`	Claude Opus 4.5 모델
`claude-opus-4-1`	Claude Opus 4.1 모델
`claude-sonnet-4-6`	Claude Sonnet 4.6 모델
`claude-sonnet-4-5`	Claude Sonnet 4.5 모델
`claude-sonnet-4`	Claude Sonnet 4 모델
`claude-haiku-4-5`	Claude Haiku 4.5 모델
`qwen3.7-max`	Qwen 3.7 Max 모델
`qwen3.7-plus`	Qwen 3.7 Plus 모델
`qwen3.6-plus`	Qwen 3.6 Plus 모델
`qwen3.5-plus`	Qwen 3.5 Plus 모델

Anthropic 호환 모델을 쓰려면:

providers:
  opencode-zen-claude:
    provider: anthropic
    base_url: https://opencode.ai/zen
    token_key: OPENCODE_API_KEY

models:
  claude:
    provider: opencode-zen-claude
    model: claude-sonnet-4-5

agents:
  root:
    model: claude
    description: Assistant using Claude through OpenCode Zen
    instruction: You are a helpful assistant.

Google 호환

이 모델들은 Google 호환 클라이언트를 쓰는 커스텀 프로바이더 정의가 필요해요:

모델	설명
`gemini-3.5-flash`	Gemini 3.5 Flash 모델
`gemini-3.1-pro`	Gemini 3.1 Pro 모델
`gemini-3-flash`	Gemini 3 Flash 모델

Google 모델을 쓰려면:

providers:
  opencode-zen-gemini:
    provider: google
    base_url: https://opencode.ai/zen
    token_key: OPENCODE_API_KEY

models:
  gemini:
    provider: opencode-zen-gemini
    model: gemini-3.5-flash

agents:
  root:
    model: gemini
    description: Assistant using Gemini through OpenCode Zen
    instruction: You are a helpful assistant.

동작 방식

OpenCode Zen은 Docker Agent의 기본 제공 alias로 구현돼 있어요:

API 유형: OpenAI 호환(GPT 모델은 Responses API 자동 감지, 그 외는 Chat Completions)
기본 URL: https://opencode.ai/zen/v1
토큰 변수: OPENCODE_API_KEY

같은 API 키가 OpenCode Go와 OpenCode Zen 양쪽에서 동작해요 — 둘은 같은 플랫폼의 일부예요. Zen은 종량제 결제 모델을, Go는 고정 구독을 사용해요.

Anthropic 호환 모델에는 같은 토큰으로 https://opencode.ai/zen을 가리키는 커스텀 프로바이더가 Anthropic 클라이언트로 쓰여요. Google 모델에는 https://opencode.ai/zen을 가리키는 커스텀 프로바이더가 Google 클라이언트로 쓰여요(Google SDK는 자체 /v1beta/models/... 경로 세그먼트를 추가해요).

OpenCode Go와의 차이

측면	OpenCode Zen	OpenCode Go
결제	종량제	$10/월 구독
모델	GPT-5.x, Claude, Gemini, 오픈소스	오픈소스 전용
무료 모델	있음(7개)	없음
기본 URL	`https://opencode.ai/zen/v1`	`https://opencode.ai/zen/go/v1`

사용 한도와 가격

OpenCode Zen은 종량제 모델을 사용해요. 현재 가격은 OpenCode Zen 문서를 참고하세요. 자동 충전과 월 사용 한도는 콘솔에서 설정할 수 있어요.

언제든지 전체 모델 카탈로그를 가져올 수 있어요:

curl https://opencode.ai/zen/v1/models

더 알아보기 (Learn more)

OpenCode Go 프로바이더로 구독형 모델 서비스 비교해 보기
Model Providers 개요에서 다른 프로바이더 살펴보기