OpenCode

What is OpenCode

OpenCode is an open-source AI coding agent available as a terminal interface, desktop app, and IDE extension. With provider configuration, it can send supported model requests through Capriole AI’s OpenAI-compatible and Anthropic-compatible endpoints.

Prerequisites

Before you begin, make sure you have:

A Capriole AI account (Sign up here)
A Capriole AI API key (Get your key)

Installation

Install OpenCode with the official install script:

curl -fsSL https://opencode.ai/install | bash

Or install it with npm:

npm install -g opencode-ai

Verify the install:

opencode --version

Configuration

Create or update ~/.config/opencode/opencode.json: Use apiKey for the OpenAI and OpenAI-compatible providers and authToken for the Anthropic provider.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "capriole-ai-openai/openai-latest",
  "small_model": "capriole-ai-openai/openai-latest",
  "enabled_providers": ["capriole-ai-openai", "capriole-ai-compatible", "capriole-ai-anthropic"],
  "provider": {
    "capriole-ai-openai": {
      "npm": "@ai-sdk/openai",
      "name": "Capriole AI OpenAI",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "apiKey": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "openai-latest": {
          "name": "OpenAI latest",
          "options": {
            "forceReasoning": true
          },
          "variants": {
            "minimal": {
              "reasoningEffort": "minimal",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "reasoningSummary": "auto"
            },
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            }
          }
        },
        "openai/gpt-5.6-terra": {
          "name": "GPT 5.6 Thinking",
          "options": {
            "forceReasoning": true
          }
        },
        "openai/gpt-5.6-luna": {
          "name": "GPT 5.6",
          "options": {
            "forceReasoning": true
          }
        },
        "openai/gpt-5.5": {
          "name": "GPT 5.5",
          "options": {
            "forceReasoning": true
          },
          "variants": {
            "minimal": {
              "reasoningEffort": "minimal",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "reasoningSummary": "auto"
            },
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            }
          }
        },
        "openai/gpt-5.4-mini": {
          "name": "GPT 5.4 mini",
          "options": {
            "forceReasoning": true
          },
          "variants": {
            "minimal": {
              "reasoningEffort": "minimal",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "reasoningSummary": "auto"
            },
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            }
          }
        }
      }
    },
    "capriole-ai-compatible": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Capriole AI Compatible",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "apiKey": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "anthropic/claude-fable-5": {
          "name": "Fable 5"
        },
        "anthropic/claude-opus-5": {
          "name": "Opus 5"
        },
        "xai/grok-4.5": {
          "name": "Grok 4.5"
        },
        "zai/glm-5.2": {
          "name": "GLM 5.2"
        },
        "moonshot/kimi-k3": {
          "name": "Kimi K3"
        }
      }
    },
    "capriole-ai-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "Capriole AI Anthropic",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "authToken": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "claude-latest": {
          "name": "Claude latest",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-fable-5": {
          "name": "Fable 5"
        },
        "claude-opus-5": {
          "name": "Opus 5"
        },
        "claude-opus-4-8": {
          "name": "Opus 4.8",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-opus-4-7": {
          "name": "Opus 4.7",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-opus-4-6": {
          "name": "Opus 4.6",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-sonnet-4-6": {
          "name": "Sonnet 4.6",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        }
      }
    }
  }
}

Run OpenCode

After replacing YOUR_CAPRIOLE_AI_API_KEY in the config, start OpenCode:

opencode

Use /models to select OpenAI latest, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, GPT 5.4 mini, Fable 5, Opus 5, Grok 4.5, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6, or Sonnet 4.6. Use Ctrl+T to cycle model variants.

Supported models

OpenCode supports OpenAI latest, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, GPT 5.4 mini, Fable 5, Opus 5, Grok 4.5, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6 through Capriole AI. Fable 5 and Opus 5 can use either the Chat Completions-compatible provider or the Anthropic Messages provider.

openai-latest
openai/gpt-5.6-terra
openai/gpt-5.6-luna
openai/gpt-5.5
openai/gpt-5.4-mini
anthropic/claude-fable-5
anthropic/claude-opus-5
xai/grok-4.5
zai/glm-5.2
moonshot/kimi-k3
claude-latest
claude-fable-5
claude-opus-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6

Troubleshooting

Why does OpenCode return an authentication error?

Confirm that both apiKey and authToken in ~/.config/opencode/opencode.json use your Capriole AI API key instead of YOUR_CAPRIOLE_AI_API_KEY.

Why do GPT requests fail?

Confirm that the GPT provider uses npm: "@ai-sdk/openai" and baseURL: "https://api.caprioletech.com/v1" so requests use the Responses API.

Why do Grok, GLM, or Kimi requests fail?

Confirm that capriole-ai-compatible uses npm: "@ai-sdk/openai-compatible" and baseURL: "https://api.caprioletech.com/v1" so both models use Chat Completions.

Why do Anthropic requests fail?

Confirm that the Anthropic provider uses npm: "@ai-sdk/anthropic", authToken, and baseURL: "https://api.caprioletech.com/v1".

Why don’t Capriole AI models appear?

Confirm that the model reference uses <providerId>/<modelId>, such as capriole-ai-openai/openai-latest, capriole-ai-compatible/moonshot/kimi-k3, or capriole-ai-anthropic/claude-latest, and that enabled_providers includes the Capriole AI providers while disabled_providers does not block them.

Why don’t model variants appear?

Confirm that you restarted OpenCode after updating ~/.config/opencode/opencode.json, then open /models and press Ctrl+T to cycle variants.

Why don’t config changes apply?

Check for project-level opencode.json or OPENCODE_CONFIG overrides, then restart OpenCode.

Why do provider initialization or provider package errors appear?

For ProviderInitError, verify the provider config first. For provider package errors, clear ~/.cache/opencode and restart OpenCode so provider packages are reinstalled.

Notes

The Anthropic provider uses authToken so the AI SDK Anthropic provider sends Authorization: Bearer authentication.
OpenCode 1.14.48 completes shell-tool workflows with Grok 4.5, GLM 5.2, and Kimi K3 through @ai-sdk/openai-compatible.
OpenCode variants are client-side model settings. They do not create new Capriole AI API model IDs.
Official references: OpenCode install, OpenCode config, OpenCode providers, OpenCode models and variants, OpenCode keybinds, OpenCode troubleshooting, OpenAI Responses API, AI SDK OpenAI provider, AI SDK Anthropic provider, Anthropic adaptive thinking, and Anthropic effort.

Get started

Endpoints

Integration

What is OpenCode

Prerequisites

Installation

Configuration

Run OpenCode

Supported models

Troubleshooting

Why does OpenCode return an authentication error?

Why do GPT requests fail?

Why do Grok, GLM, or Kimi requests fail?

Why do Anthropic requests fail?

Why don’t Capriole AI models appear?

Why don’t model variants appear?

Why don’t config changes apply?

Why do provider initialization or provider package errors appear?

Notes

​What is OpenCode

​Prerequisites

​Installation

​Configuration

​Run OpenCode

​Supported models

​Troubleshooting

​Why does OpenCode return an authentication error?

​Why do GPT requests fail?

​Why do Grok, GLM, or Kimi requests fail?

​Why do Anthropic requests fail?

​Why don’t Capriole AI models appear?

​Why don’t model variants appear?

​Why don’t config changes apply?

​Why do provider initialization or provider package errors appear?

​Notes

What is OpenCode

Prerequisites

Installation

Configuration

Run OpenCode

Supported models

Troubleshooting

Why does OpenCode return an authentication error?

Why do GPT requests fail?

Why do Grok, GLM, or Kimi requests fail?

Why do Anthropic requests fail?

Why don’t Capriole AI models appear?

Why don’t model variants appear?

Why don’t config changes apply?

Why do provider initialization or provider package errors appear?

Notes