4.2 KiB

Raw Blame History

OpenCode CLI Configuration

Free AI programming assistant, supporting 75+ models, no credit card required

OpenCode is an open-source AI programming agent that supports terminal, desktop applications, and IDE extensions. Free models can be used without an account.

Official website: opencode.ai

Installation

# One-click installation (recommended)
curl -fsSL https://opencode.ai/install | bash

# Or use npm
npm install -g opencode-ai

# Or use Homebrew (macOS/Linux)
brew install anomalyco/tap/opencode

# Windows - Scoop
scoop bucket add extras && scoop install extras/opencode

# Windows - Chocolatey
choco install opencode

Free Model Configuration

OpenCode supports multiple free model providers that can be used without payment.

Option 1: Z.AI (Recommended, GLM-4.7)

Visit Z.AI API Console to register and create an API Key
Run the /connect command, search for Z.AI
Enter your API Key
Run /models and select GLM-4.7

opencode
# After entering, type
/connect
# Select Z.AI, enter API Key
/models
# Select GLM-4.7

Option 2: MiniMax (M2.1)

Visit MiniMax API Console to register and create an API Key
Run /connect, search for MiniMax
Enter your API Key
Run /models and select M2.1

Option 3: Hugging Face (Multiple Free Models)

Visit Hugging Face Settings to create a Token
Run /connect, search for Hugging Face
Enter your Token
Run /models and select Kimi-K2-Instruct or GLM-4.6

Option 4: Local Models (Ollama)

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Pull a model
ollama pull llama2

Configure in opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "llama2": {
          "name": "Llama 2"
        }
      }
    }
  }
}

Core Commands

Command	Function
`/models`	Switch models
`/connect`	Add API Key
`/init`	Initialize project (generate AGENTS.md)
`/undo`	Undo last modification
`/redo`	Redo
`/share`	Share conversation link
`Tab`	Toggle Plan mode (plan only, no execution)

Let AI Handle All Configuration Tasks

The core philosophy of OpenCode: Delegate all configuration tasks to AI.

Example: Install MCP Server

Help me install the filesystem MCP server and configure it for opencode

Example: Deploy GitHub Open Source Project

Clone the https://github.com/xxx/yyy project, read the README, and help me complete all dependency installation and environment configuration

Example: Configure Skills

Read the project structure and create an appropriate AGENTS.md rules file for this project

Example: Configure Environment Variables

Check what environment variables the project needs, help me create a .env file template and explain the purpose of each variable

Example: Install Dependencies

Analyze package.json / requirements.txt, install all dependencies, and resolve version conflicts

Recommended Workflow

Enter project directory
```
cd /path/to/project
opencode
```
Initialize project
```
/init
```

Switch to free model

/models
# Select GLM-4.7 or MiniMax M2.1

Start working
- First use Tab to switch to Plan mode, let AI plan
- Confirm the plan before letting AI execute

Configuration File Locations

Global config: ~/.config/opencode/opencode.json
Project config: ./opencode.json (project root)
Auth info: ~/.local/share/opencode/auth.json

4.2 KiB Raw Blame History