GreenTokens

Search

Search models, guides, docs and the FAQ.

Clients

Claude Desktop

Connect Claude Desktop to GreenTokens through third-party inference.

Quick setup

Run the setup script in a terminal and choose Claude Desktop from its list. It finds Claude Desktop's settings, checks your API key, and makes the changes described below for you, backing up each file first. It can set up your other agents in the same run.

curl -fsSL https://www.greentokens.io/setup.sh | bash
  • On macOS, it adds a settings profile: approve it in System Settings under Device Management (called Profiles on older versions).
  • On Windows, it asks for administrator permission, since Windows keeps these settings in a protected place.
  • Restart Claude Desktop, then choose the third-party option on its sign-in screen, not the Anthropic sign-in.
  • Claude Desktop then shows these settings as managed, so its settings window is read-only. Run the script again to change them.
To undo, run the same command again and choose Remove.

Manual setup

Claude Desktop can send its requests to an LLM gateway that speaks the Anthropic Messages API, which GreenTokens does. Configure it from inside the app:

  1. Enable developer mode: Help → Troubleshooting → Enable Developer Mode. On Windows, open the application menu (☰) in the top-left of the sign-in screen first.
  2. Open Developer → Configure Third-Party Inference…
  3. In Connection, set Inference provider to Gateway and fill in the gateway credentials:
    • Gateway base URL: https://api.greentokens.io
    • Gateway API key: your sk-gt-… key
    • Credential kind: Static API key
    • Gateway auth scheme: Bearer (the default)
  4. Click Apply Changes. Claude Desktop relaunches using GreenTokens.
Enter the base URL exactly as shown: no /v1 and no trailing slash. Claude Desktop adds /v1/messages itself, and requires https.

Models

Claude Desktop reads the model list from GreenTokens automatically and shows the Claude models in its picker. To show only specific models instead, list their IDs in the Models section of the same window:

Models (optional)
claude-opus-5-5
claude-sonnet-5
claude-haiku-4-5

Keeping costs in check

  • Give Claude Desktop its own API key with a daily spend limit, so long Cowork or Code sessions stay within a budget.
  • Claude Desktop reuses the system prompt and earlier turns between requests, which GreenTokens bills at the lower cached-input price.