AI Tool Setup

OpenCode

Connect OpenCode to Felo through the OpenAI-compatible endpoint.

Use this guide when OpenCode asks for an OpenAI-compatible provider, API key, base URL, and model name.

Before You Start

You need one Felo API Platform key. The same key works across model protocols, agent clients, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page, and SuperAgent APIs.

export FELO_API_KEY="YOUR_API_KEY"

Recommended Setup

Item	Value
Best for	terminal coding sessions, local agents, and OpenAI-compatible model routing
Protocol	OpenAI-compatible Chat Completions
Base URL	`https://openapi.felo.ai/api/v1`
Model example	`claude-sonnet-4-6`
API key	Your `FELO_API_KEY`

Configure OpenCode

Set the environment variables first:

export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"

Client fields

If OpenCode shows provider fields, use these values:

Field	Value
Provider	OpenAI-compatible
API key	Your `FELO_API_KEY`
Base URL	`https://openapi.felo.ai/api/v1`
Model	`claude-sonnet-4-6` or another model from the Felo model list

If the client supports a Responses API mode, prefer it for agent-style tasks. If it only supports Chat Completions, use the same base URL and model name.

Verify the Setup

Run a small task after saving the configuration:

opencode

If the tool starts and answers with the selected model, the provider setup is ready.

Troubleshooting

Issue	What to check
Authentication fails	Confirm the key is copied correctly and exported as `FELO_API_KEY`
Tool calls the wrong provider	Check that the Felo provider is selected for the current workspace or session
Base URL error	Use `https://openapi.felo.ai/api/v1` for OpenAI-compatible clients and `https://openapi.felo.ai/api` for Anthropic-compatible clients
Model not found	Choose a model that appears in your Felo model list
The tool ignores local config	Move provider settings to the user-level config if the client requires it