OpenCode CLI Configuration Guide (CC Switch)

This guide explains how to install OpenCode CLI on Windows and use the model services provided by TreeRouter through CC Switch. After completing the configuration, you can run opencode in PowerShell, CMD, or WSL and access models through TreeRouter.

1. Prerequisites

Before you begin, make sure that:

You have a working TreeRouter account.

OpenCode CLI is installed or ready to be installed.

CC Switch is installed or ready to be installed.

Your network can access https://treerouter.com/.

The TreeRouter token group you intend to use contains models supported by OpenCode.

If you plan to install OpenCode CLI with npm, install Node.js and npm first. Run the following commands in PowerShell or CMD to check:

If both commands display version numbers, Node.js and npm are installed correctly.

2. Install OpenCode CLI

OpenCode recommends that Windows users use WSL for a more complete terminal experience. If you already use WSL, run the following command in a WSL terminal:

To use OpenCode CLI directly in PowerShell or CMD, install it with npm:

If Scoop or Chocolatey is already installed, you can use either of the following methods instead:

scoop install opencode

choco install opencode

After installation, close the current terminal and open a new PowerShell, CMD, or WSL terminal. Run the following command to verify the installation:

If a version number appears, OpenCode CLI has been installed successfully.

3. Install CC Switch

Follow the official TreeRouter guide to install CC Switch:

CC Switch Installation Guide

After installation, confirm that CC Switch opens normally. You will manually add an OpenCode provider configuration in CC Switch later.

Open CC Switch and confirm that an OpenCode entry appears in the application list at the top.

4. Create a Token for OpenCode

Open the TreeRouter website and sign in:

https://treerouter.com/

After signing in, select Console > Token Management > Add Token.

Opening Token Management and adding a token

Enter the following information on the token creation page:

Name: Enter an easily recognizable name, such as OpenCode Token.

Token Group: Select the group you want to use with OpenCode. Make sure it contains the models you need.

Quota Settings: Set a quota based on your requirements. Leave the default settings if no quota restriction is needed.

Access Restrictions: Leave the default settings unless you have specific network access requirements.

After confirming the information, click Submit.

5. Copy the Token Key

After the token is created, the token list will appear.

Find the token you just created. Click the Copy button next to Key in that token's row, then select Copy Key.

Important: Select Copy Key, not Copy Connection Information.

6. Add the OpenCode Configuration to CC Switch

Open CC Switch, select the OpenCode icon from the application list at the top, and then click the plus (+) button in the upper-right corner.

Adding an OpenCode provider in CC Switch

On the provider page, click Custom Configuration.

Complete the custom configuration form as follows:

Provider Name: Enter an easily recognizable name, such as My OpenCode.

Notes: Optional. Enter a description of how the configuration will be used.

Website URL: Enter https://treerouter.com/v1.

API Key: Paste the key copied from the TreeRouter token list.

Request URL: Enter TreeRouter's OpenAI-compatible endpoint, which is normally https://treerouter.com/v1. If a different endpoint is shown on the TreeRouter website or provided by customer support, use that endpoint instead.

Additional Options: Keep the default keys and values.

Model ID: Enter the ID of the model you want to use in OpenCode CLI. The model must be available in the selected token group.

If the page provides a Get Model List option, click it first. If the model list cannot be retrieved automatically, click Add Model and enter the model ID manually.

After adding the model, select it and click Add or Save.

Complete OpenCode custom provider configuration

7. Enable the Configuration and Test Connectivity

After the provider is added, CC Switch returns to the OpenCode configuration list.

Find the configuration you just added, such as My OpenCode, and activate it.

After activation, click the Connectivity Test button on the right side of the configuration.

If Connection Successful appears at the top of the page, the CC Switch configuration is working.

Testing the OpenCode provider connection

Important: After activating the configuration, close all open PowerShell, CMD, and WSL terminal windows, then open a new terminal. This ensures that OpenCode CLI reads the latest configuration written by CC Switch.

8. Verify OpenCode CLI

Open a new PowerShell, CMD, or WSL terminal and navigate to your project directory.

Run the following command to start OpenCode CLI:

If OpenCode prompts you to select a provider, sign in, or initialize the application on first launch, confirm that the OpenCode configuration in CC Switch is marked as In Use, then return to the terminal and continue.

After selecting your model, enter a simple test prompt, for example:

Confirm in one sentence that the connection is working.

If the model responds normally, OpenCode CLI has been configured successfully to use TreeRouter through CC Switch.

If this is the first time you have used OpenCode in the current project, you can also run:

/init

This command asks OpenCode to analyze the project and create or update AGENTS.md in the project root.

9. Troubleshooting

`opencode` Is Not Recognized as a Command

OpenCode CLI may not have been installed correctly, or the global command directory used by npm, Scoop, or Chocolatey may not be included in your system's PATH environment variable.

Run the installation command again. After installation, close the terminal and open a new PowerShell, CMD, or WSL terminal.

OpenCode CLI Still Uses the Default Service

Check the following:

The newly added My OpenCode configuration is active in CC Switch.

The OpenCode page is currently selected in CC Switch.

You reopened PowerShell, CMD, or WSL after activating the configuration.

The project directory does not contain a .env file with an old API key or base URL.

Old OPENAI_API_KEY, OPENAI_BASE_URL, or related environment variables have not been set manually on the computer.

If you previously ran opencode auth login, OpenCode may have stored credentials for an old provider. Run the following command to view the signed-in providers:

If old credentials are interfering with the current configuration, remove the old configuration from OpenCode or CC Switch before testing again.

The Connectivity Test Fails

Check the following:

The TreeRouter token is enabled.

The selected model is available in the token group.

The configuration is active in CC Switch.

The complete API Key was copied.

The Request URL is TreeRouter's OpenAI-compatible endpoint.

The Model ID exactly matches an available model ID in TreeRouter.

Your network can access https://treerouter.com/.

If TreeRouter is active in CC Switch but OpenCode CLI still prompts you to sign in, close all terminal windows and open a new terminal before running opencode again.

If the prompt still appears, return to CC Switch, confirm that My OpenCode is marked as In Use, and run the Connectivity Test again.

Can I Import the OpenCode Configuration from TreeRouter with One Click?

OpenCode CLI currently requires the provider configuration to be added manually in CC Switch. Use the TreeRouter website to create the token and copy its key. Do not use the website's one-click CC Switch import process to configure OpenCode CLI.

The OpenCode Entry Is Missing from CC Switch

Make sure that CC Switch has been updated to a recent version. If your version does not include the OpenCode entry, follow the TreeRouter CC Switch guide to update or reinstall CC Switch.

OpenCode CLI Configuration Guide (CC Switch)

1. Prerequisites#

2. Install OpenCode CLI#

3. Install CC Switch#

4. Create a Token for OpenCode#

5. Copy the Token Key#

6. Add the OpenCode Configuration to CC Switch#

7. Enable the Configuration and Test Connectivity#

8. Verify OpenCode CLI#

9. Troubleshooting#

opencode Is Not Recognized as a Command#

OpenCode CLI Still Uses the Default Service#

The Connectivity Test Fails#

OpenCode Prompts You to Sign In#

Can I Import the OpenCode Configuration from TreeRouter with One Click?#

The OpenCode Entry Is Missing from CC Switch#