Skip to content
jusCode
← All docsCopy raw .md
Docs · 2026-05-25

TL;DR: Add jusCode as a custom "openai" provider in ~/.opencode/config.json with base_url https://api.juscode.co/v1 and your jcg_ key. Set jusCode-auto as the default model.

Use jusCode with OpenCode

OpenCode is an open-source terminal coding agent from SST, Claude Code's open-source cousin. It supports any OpenAI-compatible endpoint, which makes jusCode a one-line config change.

Why route OpenCode through jusCode?

  • Cheaper. jusCode picks the most cost-effective capable model per call. You stop paying frontier prices for tasks that don't need it.
  • Same UX. OpenCode behaves identically: autocomplete, edits, multi-file refactors all work.
  • Vendor-independent. Switch underlying models without touching OpenCode config.

30-second setup

1. Mint a jusCode key

Sign in at juscode.co/login → dashboard → Keys tab → Mint key → copy the jcg_… token (shown once).

2. Configure OpenCode

OpenCode reads provider config from ~/.opencode/config.json. Add jusCode as a custom OpenAI-compatible provider:

{
  "providers": {
    "juscode": {
      "type": "openai",
      "base_url": "https://api.juscode.co/v1",
      "api_key": "jcg_your_key_here",
      "models": ["jusCode-auto"]
    }
  },
  "default_provider": "juscode",
  "default_model": "jusCode-auto"
}

The model name jusCode-auto is a virtual identifier; jusCode picks the actual underlying model. You can also pass any provider-prefixed model id (e.g. anthropic/claude-sonnet) and jusCode will honor it.

3. Run

opencode

Verify spend on your jusCode dashboard → Usage tab.

Pinning a specific model

If you want to override the auto-selector for a session:

opencode --model "anthropic/claude-sonnet-4.5"
# or
opencode --model "openai/gpt-5"

jusCode normalizes provider prefixes; you don't need accounts at each upstream provider.

What works

  • ✅ Streaming responses
  • ✅ Tool use (OpenCode's edit / shell / read primitives)
  • ✅ Multi-file context
  • ✅ System prompts
  • ✅ Image inputs (auto-routes to vision-capable model)

Limits

  • 60 RPM per key, 600 RPM per tenant (raisable in dashboard)
  • No model fallback at the SDK level. jusCode handles upstream failures internally and retries with a different provider transparently.

Uninstall

Remove the jusCode provider from your OpenCode config in one command:

curl -fsSL https://juscode.co/install/uninstall.sh | sh      # macOS · Linux · WSL
irm https://juscode.co/install/uninstall.ps1 | iex           # Windows PowerShell

It removes the juscode provider from ~/.opencode/config.json (and points you to your config.json.juscode-bak backup if one exists). OpenCode stays installed. Full details: Uninstall jusCode.

Agent-readable raw markdown: /docs/opencode.md