yazzang-homelab

Opencode CLI Gateway — Development skill for Claude Code

Development community

정식 OpenCode CLI를 감싼 텍스트 전용 게이트웨이와 Claude Code·Codex·GJC 연결 부록.

How to install Opencode CLI Gateway

This entry records only its repository, not the path inside it, so there is no exact command to give. Open yazzang-homelab/opencode-cli-gateway and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Opencode CLI Gateway does

정식 OpenCode CLI를 감싼 텍스트 전용 게이트웨이와 Claude Code·Codex·GJC 연결 부록.

Alternatives in Development

Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★
Agent Of Empires — Manage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile 3.1k ★
Claude Scholar — Semi-automated research assistant for academic research and software development 3k ★

README

opencode-cli-gateway

정식 **OpenCode CLI**를 요청마다 한 번 실행해 OpenAI Chat Completions API로 제공합니다. CLI는 `opencode-ai@1.19.0`으로 고정합니다. 제공 모델은 OpenCode 무료 모델 두 개이며, 요청의 `model`로 고릅니다.

모델 ID	컨텍스트	최대 출력	입력	effort
`deepseek-v4.1-flash-free`	200K	32000	텍스트·이미지	`low`·`high`·`max`
`glm-5.3-flash-free`	200K	32000	텍스트	`low`·`high`·`max`

두 모델의 한도와 effort 단계는 models.dev의 OpenCode 항목에 공시된 값이며, 무료 상류에서 텍스트·함수 호출·`low`/`high`/`max`를 실측했습니다. `glm-5.3-flash-free`는 유료 `glm-5.3`과 다른 Flash 모델입니다.

`glm-5.3-flash-free`는 models.dev에 이미지 입력이 공시되어 있지만, 무료 상류에서 실측하니 이미지를 반영하지 않았습니다. 이미지 데이터는 상류 요청에 실렸으나 이미지를 바꿔도 입력 토큰이 같았고, 단색 이미지 12건 중 5건만 색을 맞혔습니다. 같은 조건에서 DeepSeek는 6건을 모두 맞혔습니다. 따라서 게이트웨이는 GLM을 텍스트 전용으로 광고하고, 이미지가 든 요청은 400 `unsupported_content`로 거절합니다.

GLM 무료 상류는 DeepSeek보다 훨씬 느렸습니다. 2026-10-16 실측 결과는 다음과 같습니다.

측정	DeepSeek	GLM
`read` 왕복(4워커 평균)	17초	85초
텍스트(4워커 평균)	9초	50초
GJC 코딩 작업(OCI 경유, 모두 성공)	22~26초	432초

시간은 상류 상태에 따라 달라지며, 위 값은 해당 시점의 측정입니다.

**비공식·독립 프로젝트입니다.** OpenCode·Anthropic·OpenAI·Gajae-Code의 공식 제품이나 완전한 호환성을 주장하지 않습니다. 다른 클라이언트로 위장하는 헤더나 비공개 엔드포인트를 쓰지 않으며, 상류 요청은 고정 CLI가 직접 보냅니다. 무료 모델의 제공 기간·한도·가격·가용성은 상류 정책에 달려 있습니다.

동작 방식: 요청 하나 = 모델 단계 하나

클라이언트 ─ Chat Completions(전체 이력) ─▶ 게이트웨이
  게이트웨이: 요청 파일 작성 → 격리된 `opencode run` 1회 실행
  opencode-plugin.mjs (OpenCode 공식 플러그인 훅)
    experimental.chat.system.transform   → 시스템 프롬프트를 호출자 system·developer로 교체
    experimental.chat.messages.transform → 이력을 호출자의 user·assistant·tool_calls·tool 결과로 교체
    tool / tool.definition / chat.message → 함수 목록을 호출자 함수(원래 이름·JSON Schema)로 교체
    chat.params                           → temperature·top_p·max_tokens·stop·seed 등 적용
    event