Quick start

Create a key, connect your tool and make your first request in a few minutes.

FreshRouter gives you one API key for many AI models. It speaks the OpenAI and Anthropic API formats, so most tools and SDKs work by changing two settings: the base URL and the key.

1. Create a key

  1. Sign up and top up your balance in the console.
  2. Open Console → API keys and click Create key.
  3. Copy the key right away. It starts with sk- and is shown in full only once: if you lose it, create a new one.

2. Connect your tool

The dialog that shows your new key also shows how to use it, and Console → Connect has the same any time later. Everything there already has your key in it, and nothing asks you to choose a model.

The fastest way works anywhere: paste one prompt into the coding agent you use. It connects the tool it is running in. To connect something else, type it after the prompt: another tool's name, or "this project".

Prompt
Connect FreshRouter for me. It is one API key for Claude, GPT, Gemini, Grok, DeepSeek and other models, in the OpenAI and Anthropic API formats.

- My API key: ask me for it first (it starts with sk-), then use it below in place of <key>.
- OpenAI-compatible base URL: https://freshrouter.com/v1 (chat completions and the Responses API)
- Anthropic-compatible base URL: https://freshrouter.com (no /v1 at the end; for Claude models)
- Every model with its ID, context size and price: https://freshrouter.com/models.json (no key needed)
- A guide for each tool, written for agents: https://freshrouter.com/llms.txt

What to connect: the tool you are running in. If I add something after this prompt, such as another tool's name or "this project", connect that instead.

1. Claude Code, Codex, Grok Build and Pi have installers. Run the command for the tool, and nothing else is needed:
   Claude Code: curl -fsSL https://freshrouter.com/install/claude.sh | bash -s -- <key>
   Codex: curl -fsSL https://freshrouter.com/install/codex.sh | bash -s -- <key>
   Grok Build: curl -fsSL https://freshrouter.com/install/grok.js | node - <key>
   Pi: curl -fsSL https://freshrouter.com/install/pi.js | node - <key>
   In PowerShell on Windows:
   Claude Code: $env:FRESHROUTER_API_KEY="<key>"; irm https://freshrouter.com/install/claude.ps1 | iex
   Codex: $env:FRESHROUTER_API_KEY="<key>"; irm https://freshrouter.com/install/codex.ps1 | iex
   Grok Build: irm https://freshrouter.com/install/grok.js | node - <key>
   Pi: irm https://freshrouter.com/install/pi.js | node - <key>
   Each one backs up the file it changes and is safe to run again.
2. Any other tool (Cursor, Cline, OpenCode, OpenClaw, Aider, Continue, Zed and so on): add FreshRouter to the tool's own settings as a custom OpenAI-compatible provider, with the base URL and key above. Look up how in the tool's own docs or its --help first; don't guess the format. If the tool wants a list of models, take the IDs and context sizes from the model catalog. Keep the rest of its settings and back up every file you change. If it can only be set in the tool's app, tell me exactly what to paste where.
3. "This project": change only the base URL and key of the OpenAI or Anthropic SDK the project already uses, or add the official OpenAI SDK for the project's language. Put the key in the project's .env file as FRESHROUTER_API_KEY, make sure .env is in .gitignore, and never hard-code or commit the key. Keep the model ID in one setting.

Don't ask me which model to use: start on claude-sonnet-5-5, or on gpt-6.1-sol where only OpenAI models fit, and I'll change it later. When you're done, tell me what you changed and how to start using it. For a project, also send one short test request and show me the reply.

Or pick your tool in the console:

  • Claude Code, Codex, Pi, Grok Build: one command in a terminal sets the tool up.
  • Cursor, Cline, Roo Code, Kilo Code and other apps: paste the base URL and the key into the tool's settings.
  • Your own project: a prompt has your coding agent wire FreshRouter in and send a test request, or start from a code sample.

3. Or set it up by hand

FormatBase URL
OpenAI-compatiblehttps://freshrouter.com/v1
Anthropic-compatiblehttps://freshrouter.com

Send the key as Authorization: Bearer sk-…. Anthropic clients can also use the x-api-key header.

4. Make your first request

curl
curl https://freshrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-freshrouter-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
Model names here are examples. Every model's exact ID is on the pricing page (https://freshrouter.com/pricing), in https://freshrouter.com/models.json and on the Models page of your console.