Harnesses
Console works with coding agents other than OpenCode. Point a harness at the Console gateway with an API key to use any paid or Go model, and usage is billed to your workspace like any other request.
| Harness | Pay-as-you-go | Go | MCP |
|---|---|---|---|
| Claude Code | Yes | Yes | Yes |
| Codex | Yes | Yes | Yes |
| Hermes | Built in | Built in | Yes |
| Pi | Built in | Built in | Yes |
| Raycast | Extension | Extension | Yes |
Free-tier chat models are only available from within OpenCode. Other harnesses receive HTTP 403 for those models,
even with a Console API key. Use paid models or a Go subscription.
Get an API key#
Harnesses authenticate with a Console API key. The quickest option is a personal API key, which calls models as you.
- Open Account from the account menu in the Console.
- Under Personal API keys, click Add API key.
- Choose the workspace, name the key, and click Create.
- Copy the key. It is shown only once.
oc_sk_1a2b3c4d5e6f_...Usage counts toward your member budget. Use a key from a workspace with credits for pay-as-you-go, or from a workspace subscribed to Go for Go.
For shared machines or CI, owners and admins can create a service account key instead, so usage isn’t tied to one person.
Base URLs#
Pay-as-you-go and Go are served from different base URLs. Use the one that matches your plan.
| Plan | Base URL |
|---|---|
| Pay-as-you-go | https://opencode.ai/inference |
| Go | https://opencode.ai/inference/go |
Append the path for the API your harness speaks. Every API serves every paid and Go text model: Console sends a request to the model’s own endpoint when it speaks that API, and translates it otherwise.
| API | Path |
|---|---|
| OpenAI Responses | /openai/v1/responses |
| OpenAI Chat Completions | /openai/v1/chat/completions |
| Anthropic Messages | /anthropic/v1/messages |
| Gemini | /google/v1beta/models/<model>:generateContent |
https://opencode.ai/inference/go/openai/v1/chat/completionsSessions#
Send a stable session ID with every request so Console can route a conversation consistently and reuse its prompt cache. Go requires it.
x-opencode-session: ses_...Console also recognizes the native session headers sent by Claude Code, Codex, Hermes, and Pi, so they need no extra configuration.
Console MCP#
Harnesses with MCP support can manage your workspace through the Console MCP server. It uses OAuth with dynamic client registration, so you sign in from the browser instead of pasting a key.
https://opencode.ai/console/mcpEach harness page shows how to add it. OpenCode adds the server automatically as opencode_console when your workspace
enables it, and asks you to sign in from the browser the first time it uses it.