How do I install the Opencode Config skill?

Run npx skillmds@latest add diegosouzapw/opencode-config in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Opencode Config safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Opencode Config?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Opencode Config free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Opencode Config?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Opencode Config by diegosouzapw — Agent Skill

Name: Opencode Config
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

File contents

OpenCode Configuration

Overview

OpenCode config is managed via opencode.json. Configs merge by priority: project > global > remote.

Config Locations

Location	Path	Priority
Project	`./opencode.json`	Highest
Global	`~/.config/opencode/opencode.json`	Medium
Auth	`~/.local/share/opencode/auth.json`	Credentials only

Quick Reference

{
  "$schema": "https://opencode.ai/config.json",
  "model": "provider/model-name",
  "small_model": "provider/small-model",
  "provider": {
    "provider-id": {
      "options": {
        "baseURL": "https://api.example.com/v1"
      }
    }
  }
}

Adding Custom Provider

For OpenAI-compatible APIs:

{
  "provider": {
    "my-provider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Display Name",
      "options": {
        "baseURL": "https://api.example.com/v1"
      },
      "models": {
        "model-id": {
          "name": "Model Display Name"
        }
      }
    }
  }
}

Example: Z.AI Coding Plan

Different Z.AI products use different baseURLs:

Provider	baseURL	Use Case
`zai`	`https://api.z.ai/api/paas/v4`	Regular Z.AI API
`zai-coding-plan`	`https://api.z.ai/api/coding/paas/v4`	GLM Coding Plan subscription

Config for Coding Plan:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "zai-coding-plan/glm-4.7",
  "small_model": "zai-coding-plan/glm-4-flash",
  "provider": {
    "zai-coding-plan": {
      "options": {
        "baseURL": "https://api.z.ai/api/coding/paas/v4"
      }
    }
  }
}

Modes Configuration

{
  "mode": {
    "build": {
      "model": "anthropic/claude-sonnet-4-5",
      "tools": { "write": true, "edit": true, "bash": true }
    },
    "plan": {
      "model": "anthropic/claude-haiku-4-5",
      "tools": { "write": false, "edit": false, "bash": false }
    }
  }
}

CLI Commands

Command	Description
`/connect`	Add provider credentials
`/models`	Select model
`opencode auth login`	Add credentials via CLI
`opencode auth list`	List configured providers

Common Mistakes

Mistake	Fix
Wrong provider for subscription	Check if your subscription uses different baseURL
Missing baseURL for custom provider	Add `options.baseURL` in provider config
Model not appearing in `/models`	Check auth.json has credentials for provider
Wrong model after config change	Restart OpenCode to reload config

Troubleshooting

Check auth: cat ~/.local/share/opencode/auth.json
Check config: cat ~/.config/opencode/opencode.json
Verify model format: provider-id/model-name
Test provider: Run /models and check if provider appears

---name: opencode-configdescription: Use when configuring OpenCode CLI - changing default model, adding providers, setting baseURL, or troubleshooting model selection issues---# OpenCode Configuration## OverviewOpenCode config is managed via `opencode.json`. Configs merge by priority: project > global > remote.## Config Locations| Location | Path | Priority ||----------|------|----------|| Project | `./opencode.json` | Highest || Global | `~/.config/opencode/opencode.json` | Medium || Auth | `~/.local/share/opencode/auth.json` | Credentials only |## Quick Reference```json{ "$schema": "https://opencode.ai/config.json", "model": "provider/model-name", "small_model": "provider/small-model", "provider": { "provider-id": { "options": { "baseURL": "https://api.example.com/v1" } } }}```## Adding Custom ProviderFor OpenAI-compatible APIs:```json{ "provider": { "my-provider": { "npm": "@ai-sdk/openai-compatible", "name": "Display Name", "options": { "baseURL": "https://api.example.com/v1" }, "models": { "model-id": { "name": "Model Display Name" } } } }}```## Example: Z.AI Coding PlanDifferent Z.AI products use different baseURLs:| Provider | baseURL | Use Case ||----------|---------|----------|| `zai` | `https://api.z.ai/api/paas/v4` | Regular Z.AI API || `zai-coding-plan` | `https://api.z.ai/api/coding/paas/v4` | GLM Coding Plan subscription |**Config for Coding Plan:**```json{ "$schema": "https://opencode.ai/config.json", "model": "zai-coding-plan/glm-4.7", "small_model": "zai-coding-plan/glm-4-flash", "provider": { "zai-coding-plan": { "options": { "baseURL": "https://api.z.ai/api/coding/paas/v4" } } }}```## Modes Configuration```json{ "mode": { "build": { "model": "anthropic/claude-sonnet-4-5", "tools": { "write": true, "edit": true, "bash": true } }, "plan": { "model": "anthropic/claude-haiku-4-5", "tools": { "write": false, "edit": false, "bash": false } } }}```## CLI Commands| Command | Description ||---------|-------------|| `/connect` | Add provider credentials || `/models` | Select model || `opencode auth login` | Add credentials via CLI || `opencode auth list` | List configured providers |## Common Mistakes| Mistake | Fix ||---------|-----|| Wrong provider for subscription | Check if your subscription uses different baseURL || Missing baseURL for custom provider | Add `options.baseURL` in provider config || Model not appearing in `/models` | Check auth.json has credentials for provider || Wrong model after config change | Restart OpenCode to reload config |## Troubleshooting1. **Check auth:** `cat ~/.local/share/opencode/auth.json`2. **Check config:** `cat ~/.config/opencode/opencode.json`3. **Verify model format:** `provider-id/model-name`4. **Test provider:** Run `/models` and check if provider appears

Frequently asked questions

Opencode Config