OpenCode Integration with RezeAI Tutorial

OpenCode is a powerful terminal AI programming tool (supporting both CLI and TUI interfaces), enabling code generation, project analysis, and file operations directly in the terminal using natural language.

This article will guide you through replacing OpenCode's underlying models with the RezeAI aggregation interface, resulting in a more stable and cost-effective programming assistance experience (supporting both GPT and Claude series models).

I. Pre-Integration Preparation (3 Core Elements)

Please log in to the RezeAI console to obtain your dedicated access information:

| Configuration Items | Recommended Content | Notes |

| :--- | :--- | :--- |

| API Key | sk-xxxxxxxxxxxxxxxx | Please directly enter the Key generated in the RezeAI console |

| Base URL | https://api.rezeai.com/v1 | Must include the /v1 suffix |

| Model Name | For example, gpt-5 or claude-opus-4-6 | Enter the model that RezeAI actually supports and that your account has permission to access |

II. Installing OpenCode

Please ensure that Node.js (version 18 or higher) is installed on your computer.

If your environment does not have Node.js, click here to download

Open a terminal (Windows recommends using PowerShell, macOS/Linux uses the terminal), and run the following commands:

NPM global installation (Windows recommended):

Official one-click installation script (macOS/Linux recommended):

After installation, run opencode --version. If the version number is output successfully, the installation is successful.

III. Configuring and Starting RezeAI

To allow you to seamlessly use both GPT and Claude models simultaneously, it is recommended to directly modify the OpenCode local configuration file.

Step 1: Configure the Network Node (Provider)

Locate or create the configuration file:

Windows path: C:\Users\Your username\.config\opencode\opencode.json

macOS / Linux path: ~/.config/opencode/opencode.json

(If the corresponding folder does not exist, please create it manually)

Paste the following JSON content into it and save it (this will override the default addresses of OpenAI and Anthropic):

``json

{
"$schema": "https://opencode.ai/config.json",

"provider": {

"openai": {

"options": {

"baseURL": "https://api.rezeai.com/v1"

}
},

"anthropic": {

"options": {

"baseURL": "https://api.rezeai.com/v1"

}
}


### Step 2: Configure the Authentication Key (Auth)

1. Locate or create the key file:

* **Windows path**: `C:\Users\Your Username\.local\share\opencode\auth.json`

* **macOS / Linux path**: `~/.local/share/opencode/auth.json`

*(If the corresponding folder does not exist, please create it manually)*

2. Paste the following JSON content and save it (**Remember to replace `sk-...` with your actual RezeAI API Key**):

``json

{
"openai": {

"type": "api",

"key": "sk-your RezeAI key"

},

"anthropic": {

"type": "api",

"key": "sk-your RezeAI key"

}
}

IV. Getting Started and Model Switching

After configuration, reopen your terminal to begin using it.

Call up the model list: Type /models in the input box and press Enter. Select the model you want to use from the list (for example, if you select the Claude model, it will automatically use the Anthropic channel configured above).

Start the conversation: Enter your first command, for example:

Write a piece of Python bubble sort code

If the model can read the request correctly and stream the code, congratulations, RezeAI has been successfully integrated!

V. Common Problem Troubleshooting (FAQ)

Q1: Why does it say authentication failed / Invalid API Key?

Check if the API Key in auth.json is copied completely, ensuring there are no extra spaces.

Check if the file format is standard JSON (punctuation marks must be English half-width characters).

Q2: Why does it say connection timed out or Fetch Failed? **

Please ensure that the baseURL in opencode.json correctly includes the /v1 suffix (i.e., https://api.rezeai.com/v1).

Q3: Why does it say "Model not found"?

You can enter /models in the dialog box to view the list of models currently supported by the tool. As long as you select a model and the RezeAI backend supports mapping that model, it can be used normally.

OpenCode

OpenCode Integration with RezeAI Tutorial#

I. Pre-Integration Preparation (3 Core Elements)#

II. Installing OpenCode#

III. Configuring and Starting RezeAI#

Step 1: Configure the Network Node (Provider)#

IV. Getting Started and Model Switching#