Claude Cowork / Desktop

Use Foza models with Claude Desktop and Claude Cowork

Setup#

Connect Claude Desktop or Claude Cowork to the Foza gateway.

Use this flow when the app accepts a custom Anthropic-compatible API base URL. If your build only supports the official Claude account login, use Claude Code, Cline, or another tool that exposes custom provider settings.

Get your API key

If you don't have one yet, create an API key at Console → API Keys and subscribe it to an Anthropic model (e.g., anthropic/claude-sonnet-4.6).

Edit configuration file

Open the Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following:

{
  "apiBaseUrl": "https://api.foza.ai/v1",
  "apiKey": "sk-foza-xxxxx"
}

If your app exposes these fields in a settings UI instead of a JSON file, use the same values:

API Base URL: https://api.foza.ai/v1
API Key: sk-foza-xxxxx

Restart Claude Desktop

Restart the application. Claude Desktop / Cowork will now route all requests through the Foza gateway.

Run a small test

Ask it to summarize a file or explain a small snippet before using it for larger edits.

Troubleshooting#

Symptom	What to check
Config ignored	Restart the app after editing the config file
JSON parse error	Validate the config file and remove trailing commas
Auth failure	Confirm the Foza key is subscribed to an Anthropic-compatible model
No custom base URL support	Use Claude Code or another OpenAI/Anthropic-compatible coding tool

Make sure you've subscribed your API key to an Anthropic model before connecting.

Claude Code

Codex CLI