Docs v0.9.93

Providers

TatsuCode supports multiple provider types so you can choose the best tradeoff between cost, speed, privacy, and model variety.

Primary command: /connect Alias: /providers

Provider Options at a Glance

Provider TypeCost ModelBest For
OAuth SubscriptionsUsually $0 extraReusing plans you already pay for
OpenRouter APIPay-per-useMaximum model variety in one place
Local ProvidersFree after setupPrivacy, offline work, fixed cost hardware

OAuth Providers (Use Existing Subscriptions)

If you already pay for AI subscriptions, connect supported routes directly and use that quota inside TatsuCode.

OpenAI Plus / Pro

Subscription: chatgpt.com

To connect:

  1. Run /connect
  2. Select OpenAI Plus/Pro
  3. Sign in and approve access
  4. Complete sign-in and return to TatsuCode when prompted

GitHub Copilot

Subscription: github.com/features/copilot/plans

To connect:

  1. Run /connect
  2. Select GitHub Copilot
  3. Sign in and approve access
  4. Complete sign-in and return to TatsuCode when prompted

For broader model coverage, use OpenRouter API key access.


OpenRouter (API Key)

OpenRouter gives you access to a large cross-provider catalog from one key.

Why OpenRouter

  • One API key for many model families
  • Fast switching between providers
  • Pay only for usage
  • Easy fallback when one provider is unavailable

Setup

  1. Create account: openrouter.ai
  2. Add credits
  3. Create API key: openrouter.ai/keys
  4. Run /connect
  5. Open OpenRouter
  6. Paste key and save

Quota and Spend Monitoring

Use:

/usage
/usage-quota

/usage-quota now includes clearer subscription/quota visibility and OpenRouter balance/usage summaries in recent builds.


Local Providers (Ollama, LM Studio, etc.)

For local/private workflows, add a custom OpenAI-compatible endpoint.

Local Endpoint Setup

Use the endpoint URL provided by your local model server.

Examples depend on your local server configuration and should be taken from your server's own documentation.

Setup Flow

  1. Start your local server
  2. Run /connect
  3. Choose Add Custom Provider
  4. Enter name + URL
  5. Save and test
  6. Run /models to pick a model

Web Search Providers

TatsuCode can be configured with your own search API keys.

  • Google Programmable Search
  • Brave Search API

Configure them inside /connect under the Web Search section.


Connection Management Tips

Inside Provider Connections you can:

  • Connect/disconnect providers
  • Verify API keys
  • View available model counts
  • Switch fallback providers if one is down

If a provider is removed, TatsuCode now handles model fallback more gracefully so you can keep working.


Troubleshooting

Invalid API Key

  • Re-copy key from provider dashboard
  • Remove leading/trailing spaces
  • Confirm key is active

OAuth Won't Complete

  • Try disconnect + reconnect
  • Retry promptly if the sign-in step expires
  • Retry from a fresh browser session

Local Provider Not Reachable

  • Confirm your local server is running
  • Re-check the configured endpoint
  • Validate local network/firewall policy

Next Steps

Type to search documentation

Use to navigate, Enter to select