opencode-go-clpx

A CLIProxyAPI plugin exposing OpenCode Go as opencode-go, with shared key pooling, protocol translation and per-key quotas. Fork of massiveits/opencode-go-cliproxyapi, using the distinct plugin ID opencode-go-clpx so both store listings can coexist. Includes upstream v0.1.10 with Codex CLI support.

Install

Add this repo as a third-party store source in CLIProxyAPI's config.yaml:

plugins:
  enabled: true
  store-sources:
    - "https://raw.githubusercontent.com/tympom/opencode-go-cliproxyapi/main/registry.json"

Then install from the Management Center's Plugin Store page (or POST /v0/management/plugin-store/opencode-go-clpx/install) and restart CLIProxyAPI.

Configuration

Only api-keys is needed. It goes in CLIProxyAPI's config.yaml under plugins.configs.opencode-go-clpx.

The one-key setup (copy this)

Use your raw OpenCode Go key (not a proxy client key; no Bearer prefix):

plugins:
  configs:
    opencode-go-clpx:
      api-keys:
        - value: "sk-..."     # your OpenCode Go API key, exactly as shown at opencode.ai
          label: "work"       # any short name; no spaces is safest

api-keys is always a list. Optional label names the quota card and auth file (opencode-go-work.json); omit it for a masked suffix (opencode-go-key-Xf9a.json). Short labels without spaces are safest.

Alternatively, in Management Center (Plugins -> Edit config):

[{"value": "sk-...", "label": "work"}]

More examples

Add one item per key with distinct labels. Unlabeled shorthand accepts bare strings and environment variables:

      api-keys:
        - "sk-..."
        - "${OPENCODE_GO_API_KEY}"

A fresh store install registers without keys, so the editor works before any key is set; with no keys the plugin serves no models. Duplicate key values are rejected.

Optional settings

Key	Default	Meaning
base-url	https://opencode.ai/zen/go/v1	Upstream base URL
catalog-url	{base-url}/models	Catalog endpoint override
model-prefix.enabled	true	true -> opencode-go/<model>, false -> bare <model>
model-prefix.value	opencode-go	Prefix name
catalog.refresh-interval	15m	Discovery cadence, minimum 1m
catalog.stale-while-unavailable	true	Keep the last good catalog when a refresh fails
protocols.chat-completions, .messages, .responses	true	Enable models routed to /v1/chat/completions, /v1/messages, /v1/responses
route-overrides	none	Per-model route, wins over built-in prefix routing
request-timeout	5m	Upstream request timeout
max-response-bytes	67108864 (64 MiB)	Max non-streaming response body
allow-http	false	Allow http:// URLs, for local mocks and tests

      route-overrides:
        "custom-model":
          protocol: "messages"       # chat-completions | messages | responses
          endpoint: "/v1/messages"   # must start with /

Notes

• Auth files: renaming a label creates a new file; manually remove the old one in Auth Files. Same-name keys get a 12-hex disambiguator rather than overwrite each other.
• Quota page: Management Center -> OpenCode Go Quota. Reset times show local date/time and a countdown. Page load never contacts upstream; refresh cards individually or with Refresh All.
• Built and tested against CLIProxyAPI v8.0.21.