Skip to main content
OpenCode can connect to 4096bytes through an OpenAI-compatible Provider. Write the dashboard-generated opencode.json config into an OpenCode config file. Prefer copying the config from the dashboard Use key dialog. The OpenCode tab inserts the current API Key, Base URL, and model names in OpenCode format.

​
Prerequisites

  • You have completed Create an account.
  • You have completed Get an API Key.
  • OpenCode is installed and opencode --version works.
  • The Use key dialog is open for the API Key you want to use.
The API Key in opencode.json is stored as a local plaintext credential. Do not commit config files, screenshots, or terminal output that include a full API Key.

​
Install

If OpenCode is not installed, check the latest instructions in the OpenCode documentation. macOS or Linux: 
curl -fsSL https://opencode.ai/install | bash
If you use npm for global CLI tools: 
npm install -g opencode-ai
After installation, reopen the terminal and verify: 
opencode --version

​
Copy config from the dashboard

1

Open API Keys

Open the dashboard and go to API Keys.
2

Choose OpenCode

Find the key you want to use for OpenCode, click Use key, then choose OpenCode.
3

Copy config

Copy the generated opencode.json content. The sample is only a reference. Use the Base URL, API Key, and model names shown in your dashboard.
4

Write the config file

For global use, write it to ~/.config/opencode/opencode.json. For project-only use, write it to opencode.json in the project root.

​
Config file paths

ScopePathUse case
Global config~/.config/opencode/opencode.jsonUse 4096bytes by default in all projects.
Project configopencode.jsonUse this config only in the current project.
Create the file manually if it does not exist. Project config has higher precedence than global config.

​
Verify

Save the config, go to a project directory, and run: 
opencode
After OpenCode opens, start with a low-risk prompt: 
Describe the purpose of the current directory in one sentence. Do not modify files.
If OpenCode responds without authentication or model errors, the config is active.

​
Common issues

Check that opencode.json is valid JSON. Confirm apiKey has no missing characters, newlines, or extra spaces.
The model ID must match the model name shown in the dashboard. Do not copy names from someone else’s screenshot.
Confirm you edited the file OpenCode is actually reading. A project-root opencode.json overrides matching fields in global config.
Yes, but /connect only stores credentials. Provider, Base URL, and model list should still come from the dashboard-generated opencode.json.