Skip to main content

​
Overview

OpenCode Interface OpenCode is a Go-based open-source command-line programming tool (CLI) that provides powerful AI assistance for developers. It offers an intuitive Terminal User Interface (TUI) and supports multiple LLM providers including OpenAI, Anthropic, Gemini, and more. By integrating OpenCode with EvoLink API, you can access EvoLink’s Claude models (such as Claude 4.5 Opus, Claude 4.5 Sonnet, Claude 4.5 Haiku) through a unified interface with one key and one base URL.

​
Prerequisites

Before configuring, make sure you have:

​
1. Terminal Emulator

OpenCode requires a modern terminal emulator. Recommended options:
  • WezTerm (cross-platform)
  • Alacritty (cross-platform)
  • Ghostty (Linux and macOS)
  • Kitty (Linux and macOS)
Windows users can also use PowerShell or Windows Terminal. macOS users can use the built-in Terminal.app or iTerm2. Linux users can use the built-in terminal or GNOME Terminal, Konsole, etc.
  • Log in to EvoLink Dashboard
  • Find API Keys in the dashboard, click ‘Create New Key’ button, then copy the generated Key
  • API Key usually starts with sk-

​
How to Open Terminal

  • Method 1: Press Win + R, type cmd or powershell, then press Enter
  • Method 2: Search for “Command Prompt” or “PowerShell” in the Start menu
  • Method 3: Hold Shift and right-click in a folder, select “Open PowerShell window here”

​
Step 1: Install OpenCode

The easiest way is through the install script:
curl -fsSL https://opencode.ai/install | bash
Or using Homebrew:
brew install anomalyco/tap/opencode

​
Verify Installation

opencode --version
Success indicator: Shows version information. If you prefer a graphical interface, OpenCode also offers a desktop app available at OpenCode Download Page.

​
1. Initialize Provider

After installation, run the following command in your terminal before launching OpenCode: 
opencode auth login
Select Provider
  1. In the provider list, select other (at the bottom, you can search for it)
  2. Enter Provider ID: type evolink
Enter Provider ID
  1. Enter API Key token: you can enter any value (e.g., admin), the actual key is referenced via config file
Enter API Key This step registers a custom provider in OpenCode’s local credential manager.

​
2. Edit Config File

Open the OpenCode config directory:
Press Win + R, paste the following, then press Enter:
%userprofile%\.config\opencode
Windows Config Directory
Create or edit opencode.json in this directory: 
{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}
⚠️ Important:
  • Replace "your-evolink-api-key" with your actual API Key
  • JSON format is sensitive to symbols

​
Step 3: Start Using OpenCode

​
1. Launch OpenCode

After saving the config file, restart your terminal, then navigate to your working directory: 
cd <your-working-directory>
Launch OpenCode: 
opencode

​
2. Verify Configuration

In the chat interface, enter the command: 
/models
OpenCode Interface and Model Selection You should see Evolink and its models in the model list. Select one and you’re ready to go!

​
FAQ

​
1. What is OpenCode and what is it used for?

OpenCode is an open-source terminal AI coding assistant with a modern TUI interface. It supports code editing, file operations, and command execution, ideal for AI-assisted programming in terminal environments.

​
2. How do I verify installation and configuration on first use?

Run these steps in sequence:
  • opencode --version: Confirm OpenCode is installed
  • Launch OpenCode and enter /models: Confirm you can see the configured models

​
3. Where should the config file be placed?

The opencode.json config file should be placed at:
  • Windows: C:\Users\{username}\.config\opencode\opencode.json
  • macOS / Linux: ~/.config/opencode/opencode.json

​
4. What models does OpenCode support?

Through EvoLink API, OpenCode supports these Claude models:
  • Claude 4.5 Opus: Most powerful model for complex tasks
  • Claude 4.5 Sonnet: Balanced performance and speed
  • Claude 4.5 Haiku: Fastest model for simple tasks

​
5. How do I switch models?

In the OpenCode interface, enter the /models command, then select your desired model from the list.

​
6. Why don’t my config changes take effect?

  • Restart OpenCode
  • Check opencode.json syntax (JSON format)
  • Verify config file path is correct

​
7. What causes 401/403 errors?

  • 401 error: API Key not set or invalid
  • 403 error: Insufficient permissions or expired key
  • Check the apiKey in your config file

​
8. Will OpenCode automatically read or upload my local files and code?

OpenCode only reads file content when you explicitly authorize it. It’s recommended to use it in a dedicated project folder.

​
9. Does OpenCode support Chinese input and output?

Yes, fully supported.

​
10. What scenarios is OpenCode suited for?

Suited for:
  • Code writing, debugging, and refactoring
  • AI-assisted programming in terminal environments
  • File content analysis and processing
  • Users who prefer modern TUI interfaces
Not suited for:
  • Complex GUI interactions
  • Users unfamiliar with terminal operations

​
Notes

Run OpenCode in a dedicated project folder. Avoid running it in sensitive directories (such as system folders or directories containing credentials). OpenCode operates starting from the current working directory.
OpenCode uses JSON format config files. Ensure your config file syntax is correct. You can use online JSON validators to check the format.