Skip to content
View as Markdown

App setup guides

Tested, step-by-step setup for 24 apps. Each guide lists the exact values to paste, the steps in the app, and fixes for the errors people run into. Every guide was checked against the app's own source or documentation, and Claude Code and Codex were also run end to end against the live API.

All guides need the same three things: a FreeTheAI account, an API key, and today's check-in.

You needValue
Base URL (most apps)https://api.freetheai.org/v1
Full chat URL (JanitorAI, TypingMind)https://api.freetheai.org/v1/chat/completions
Anthropic base URL (Claude Code)https://api.freetheai.org
ModelAn fta/ ID from freetheai.org/models, such as fta/zai/glm-5.3

Your app is not listed? Any app with a custom OpenAI-compatible base URL works: use the base URL above, your key, and a model ID.

Roleplay apps ​

AppHow it connects
JanitorAIProxy settings: the full chat completions URL, your key, and a model ID, then a page refresh.
SillyTavernChat Completion with the Custom (OpenAI-compatible) source. Lists every model your key can use.
Chub AIAn OpenAI reverse proxy in Secrets, then the model in Configuration.
RisuAICustom API model (OpenAI Compatible). On the web, turn on Force Plain Fetch.
TavoA Custom (OpenAI Protocol) connection on Android and iPhone.

For roleplay, start with fta/zai/glm-5.3. The fta/dog/ and fta/lion/ models refuse roleplay. More in Models and IDs.

Chat apps ​

AppHow it connects
Open WebUIAn OpenAI API connection that lists every model your key can use.
LibreChatA custom endpoint in librechat.yaml, with the key in .env.
LobeHub (LobeChat)A custom provider with the OpenAI request format.
ChatboxOpenAI API Compatible mode, on desktop, mobile, and the web.
Cherry StudioAn OpenAI-type provider; enter the root address, Cherry adds /v1.
NextChatA custom OpenAI endpoint and a custom model list.
TypingMindCustom models with the full chat completions URL and an Authorization header.
AnythingLLMThe Generic OpenAI provider.
Page AssistAn OpenAI compatible provider in the browser extension.

Coding tools ​

ToolHow it connects
Claude CodeANTHROPIC_BASE_URL and a tested settings.json, through Anthropic Messages.
Codex CLIA custom model provider in config.toml, through the Responses API.
OpenCode/connect for the key and a provider in opencode.json.
Kilo CodeAn OpenAI Compatible custom provider in VS Code and the CLI.
ClineThe OpenAI Compatible API provider in VS Code.
ContinueA model entry in config.yaml with the openai provider.
AiderOPENAI_API_BASE, OPENAI_API_KEY, and the openai/ model prefix.
ZedAn OpenAI compatible provider for the agent panel.
VS Code Copilot ChatThe Custom Endpoint provider (bring your own key), even without a Copilot plan.
Hermes AgentA custom endpoint with hermes model or config.yaml.

Coding tools need tool calls. Start with fta/zai/glm-5.3, and turn on Tool-capable models only on the key you use for agents (key settings). Free accounts run one request at a time; most coding tools retry the extra requests on their own.

FreeTheAI documentation. Paid models and plans are coming soon; the free tier has daily limits.