Start typing to search the documentation.

Console navigation

Providers

Connect provider accounts you already pay for, such as Anthropic, OpenAI, or AWS Bedrock, and share their models with everyone in the workspace. Console stores the credential and serves each provider through its gateway, so members use the models without ever seeing the provider key. The same gateway is available to your own tools through the Providers API.

Owners and admins manage providers from the Providers tab. Members get the enabled models in OpenCode after running /connect.

Connect a provider

  1. Open Providers and click Connect Provider.
  2. Pick a provider from the catalog and enter its API key.
  3. Optionally click Test connection, then click Save.

The catalog includes Anthropic, OpenAI, Google, xAI, DeepSeek, Mistral, Groq, OpenRouter, and many more. Catalog providers come with their models preconfigured.

Cloud providers

Cloud providers need a few extra details.

ProviderDetails
AzureResource name and API key
AWS BedrockRegion and API key
Google Vertex AIRegion and service account JSON
Cloudflare AI GatewayAccount ID, Gateway ID, and API token
DatabricksWorkspace URL and token

Custom providers

Click Add Custom Provider to connect any other endpoint, then add its models with Add Model.

FieldDescription
Base URLWhere Console forwards requests, for example https://api.deepseek.com/v1.
FormatChat Completions, Responses API, Anthropic Compatible, or Google Generative AI.
Auth modeBearer, API key header, or Custom header.
CredentialThe key Console sends to the provider.

Choose models

Open a provider to see its models. Only enabled models are available to members.

  • Use the Enabled toggle to turn a model on or off.
  • Turn on New models to enable models the provider adds in the future.

Edit models

Click a model to edit it. Changes are saved when you close the panel.

SectionWhat you can change
GeneralDisplay name, API ID, tools support, input and output types
VariantsVariants with their own headers or body
ConfigurationDefault variant, request headers and body, token limits
Cost TiersInput, output, cache read, and cache write prices per 1M tokens

Custom pricing

Catalog models start with the provider’s list price. If you have negotiated pricing, for example a discount on your OpenAI contract, override the prices under Cost Tiers so usage reports and budgets match what you actually pay.

FieldList priceYour price
Input price$2.50$2.00
Output price$15.00$12.00
Cache read price$0.25$0.20

Prices you change are highlighted on the provider page. Use Restore default value on a field, or ⋯ › Restore… on the model, to return to the list price.

Add a Context tier when a model charges more above a context size, for example for prompts over 200K tokens.

Custom models

Click Add Model to add a model the catalog doesn’t include, with its Display name and Model ID. Use ⋯ › Duplicate… on an existing model to start from its settings.

OpenCode models

The Models tab manages the models Console provides, which are paid from workspace credits. It works like a provider page:

  • Turn individual models on or off.
  • Turn Free models off to block free models for the workspace.
  • Turn New models on to enable new Console models automatically.

Disable the whole provider from ⋯ › Disable to use only your own providers.

Use in OpenCode

Members run /connect and choose the workspace. Each enabled provider appears as the workspace name followed by the provider name, and /models lists its enabled models.

Acme Inc. / Anthropic

Turn on Managed providers only in Settings › General to restrict OpenCode to the workspace’s providers for everyone.

Disable or remove

Open the provider’s ⋯ menu:

  • Disable hides the provider and its models from members but keeps its settings.
  • Remove… deletes the provider and its models. The dialog shows who used it recently, and offers Disable instead.

To rotate a key, click the credential on the provider page and enter the new one.

Billing

The provider bills you for tokens; Console does not charge credits for them. Console still records each request and its cost using the model’s pricing, so usage reports and budgets include it.

To call a provider from your own tools instead of OpenCode, use the Providers API.