← 새소식으로 돌아가기
developer

OpenCode용 SessionCast 프로바이더 공개 — 터미널에서 원하는 LLM 사용

이미 OpenCode를 터미널 AI 코딩 어시스턴트로 사용하고 계신가요? SessionCast 프로바이더를 추가하면 모든 AI 요청을 로컬 CLI 에이전트를 통해 라우팅할 수 있습니다 — 원하는 LLM 백엔드를 자유롭게 선택하고, 벤더 종속 없이, 인증 문제 없이 사용하세요.

SessionCast 웹 뷰어 — OpenCode 통합 데모
SessionCast 웹 뷰어 — OpenCode 통합 데모

OpenCode & Oh My OpenCode

두 가지 도구, 두 가지 프로바이더. 워크플로우에 맞는 하나를 선택하세요 — 둘 다 설치할 필요는 없습니다.

OpenCode 는 Go 기반의 터미널 AI 코딩 어시스턴트입니다. 터미널에서 바로 사용할 수 있는 TUI(Terminal User Interface)를 제공하며, Cursor나 Claude Code의 오픈소스 대안이라고 볼 수 있습니다. OpenAI, Anthropic, Gemini 등 다양한 LLM 프로바이더를 지원하며, 이제 SessionCast도 사용할 수 있습니다.

Oh My OpenCode 는 OpenCode 위에 전문화된 AI 에이전트를 추가하는 TypeScript 레이어입니다. Sisyphus(끈질긴 문제 해결), Oracle(코드 리뷰 및 분석), Prometheus(창의적 생성) 등 각 에이전트가 고유한 프롬프트 전략과 성격을 가지고 있어, 범용 어시스턴트 하나로는 부족한 워크플로우에 적합합니다.

동작 방식

OpenCode
  → SessionCast Provider
    → SessionCast Relay
      → CLI Agent (사용자 머신)
        → Claude Code / Ollama / OpenAI / Gemini ...

Option A — OpenCode (Go)

Go 버전에는 SessionCast 프로바이더가 내장되어 있습니다. ~/.sessioncast.yml이 있으면 자동으로 감지하여 sessioncast/default를 사용 가능한 모델로 등록합니다.

OpenCode 설치

go install github.com/anomalyco/opencode@latest

SessionCast Agent 설치 및 시작

# CLI 설치
npm i -g sessioncast-cli

# 로그인 (~/.sessioncast.yml 생성)
sessioncast login

# CLI 에이전트 시작
sessioncast agent

환경 변수 (선택)

설정 파일 대신 환경 변수로도 구성할 수 있습니다:

export SESSIONCAST_RELAY_URL="wss://relay.sessioncast.io/ws"
export SESSIONCAST_TOKEN="agt_YOUR_TOKEN"
export SESSIONCAST_MACHINE_ID="my-machine"    # 선택
export SESSIONCAST_MODEL="claude-code"         # 선택, 기본값: claude-code

~/.sessioncast.yml이 있으면 환경 변수 없이도 자동 감지됩니다.

OpenCode 모델 설정 (선택)

~/.opencode.json에서 특정 에이전트에 SessionCast 모델을 지정할 수도 있습니다:

{
  "agents": {
    "coder": { "model": "sessioncast/default" },
    "task": { "model": "sessioncast/default" }
  }
}

실행

opencode

Option B — Oh My OpenCode (TypeScript)

SessionCast 프로바이더가 포함된 포크 버전을 제공하며, 모든 에이전트가 로컬 CLI 에이전트를 통해 동작합니다.

Oh My OpenCode for SessionCast 설치

git clone -b feat/sessioncast-provider \
  https://github.com/sessioncast/oh-my-opencode-for-sessioncast.git
cd oh-my-opencode-for-sessioncast
npm install && npm run build
npm link   # 'oh-my-opencode' 글로벌 명령어 등록

SessionCast Agent 설치 및 시작

npm i -g sessioncast-cli
sessioncast login
sessioncast agent

에이전트 설정

~/.config/opencode/oh-my-opencode.json 파일을 생성합니다:

{
  "agents": {
    "sisyphus": { "model": "sessioncast/claude-code" },
    "oracle": { "model": "sessioncast/claude-code" },
    "prometheus": { "model": "sessioncast/claude-code" }
  }
}

실행

oh-my-opencode run 'Kubernetes가 뭔지 2문장으로 설명해줘.'

테스트 결과

Oh My OpenCode + SessionCast 프로바이더로 3개의 통합 테스트를 실행했습니다:

  • 테스트 1 — Docker: "What is Docker? Answer in 2 sentences." — 8.7초
  • 테스트 2 — Kubernetes: "Explain what Kubernetes is in 2 sentences." — 8.6초
  • 테스트 3 — Container Runtime: "What is a container runtime? One sentence only." — 9.9초

각 테스트의 요청 흐름:

Oh My OpenCode → OpenCode → SessionCast Relay → CLI Agent → Claude Code CLI → Claude API

BYOAI — Bring Your Own AI

~/.sessioncast.yml에서 선호하는 LLM 백엔드를 설정하세요:

api:
  llm:
    provider: claude-code   # 또는 ollama, openai, anthropic, gemini
    model: sonnet

OpenCode 설정 변경 없이 모델을 전환할 수 있습니다. 프로바이더는 sessioncast/claude-code로 유지되고, 백엔드만 바뀝니다.

OAuth 제한 정책과 SessionCast

Anthropic은 최근 규정 준수 정책을 업데이트하여, Claude Pro/Max OAuth 토큰을 서드파티 도구에서 사용하는 것을 금지했습니다. 일부 도구들(OpenCode 초기 버전 포함)은 Claude Code 클라이언트 신원을 스푸핑하여 소비자 구독의 OAuth 인증으로 요청을 라우팅하고 있었고, Anthropic은 이를 명시적으로 금지했습니다:

"Claude Free, Pro, Max 계정에서 취득한 OAuth 토큰을 다른 제품, 도구, 서비스에서 사용하는 것은 허용되지 않습니다."

SessionCast는 이 제한의 영향을 받지 않습니다. 그 이유:

  • OAuth 토큰 미사용. SessionCast는 Claude의 OAuth 토큰을 사용하지 않습니다. 클라이언트 신원을 위조하거나 구독 인증 정보를 가로채지 않습니다.
  • 사용자 자체 API 키. Claude를 백엔드로 사용할 때, SessionCast CLI 에이전트는 사용자의 API 키로 Anthropic API를 직접 호출합니다 — 일반적인 API 연동 방식과 동일합니다.
  • 로컬 실행. CLI 에이전트는 사용자 머신에서 로컬로 실행됩니다. 코드는 사용자 머신에 머물며, 설정된 LLM 프로바이더로 직접 전달됩니다. SessionCast 릴레이는 OpenCode 클라이언트와 로컬 에이전트 간의 메시지만 중계합니다.
  • 프로바이더 비종속. Ollama를 사용하면 외부 데이터 전송 없이 완전한 로컬 추론이 가능하고, OpenAI, Gemini 등 다른 프로바이더로도 자유롭게 전환할 수 있습니다. 특정 벤더에 종속되지 않습니다.

한마디로: SessionCast는 다른 사람의 구독을 감싸는 래퍼가 아니라, 사용자 자체 인프라로 향하는 투명한 릴레이입니다.

링크

불러오는 중...