Files
2026-07-13 12:52:40 +08:00

103 lines
3.7 KiB
Plaintext

---
title: "Authorization"
description: "Authenticate with Cline and choose your first AI model"
---
Cline connects to AI models through a **provider**. You have three common paths:
- **Cline (usage-billing)** (recommended): sign in with Google/GitHub/email, no API key setup.
- **ClinePass**: a $9.99/month subscription provider with access to selected open coding models and 2-5x API rate limits.
- **Bring Your Own Key (BYOK)**: use your own provider credentials (cloud or local runtimes).
## Menu
- [IDE Setup](#ide-setup)
- [CLI Setup](#cli-setup)
## IDE Setup
<Steps>
<Step title="Open Cline Settings">
Click the settings icon (⚙️) in the Cline panel.
</Step>
<Step title="Select Provider">
Choose your desired provider from the **API Provider** dropdown.
</Step>
<Step title="Authenticate">
- **Cline (usage-billing):** Click **Sign In** and complete OAuth.
- **ClinePass:** Select **ClinePass**, click **Sign In**, and subscribe if prompted.
- **BYOK cloud provider:** Paste your API key into the **API Key** field.
- **Local runtime (Ollama/LM Studio):** no key needed; ensure runtime is running.
</Step>
<Step title="Select Model">
Choose your desired model from the **Model** dropdown.
</Step>
</Steps>
## Provider Options
### Cline (usage-billing)
- One sign-in, no key management
- Built-in billing and free model options
- Access to multiple providers from one account
Add credits in Cline settings or at [app.cline.bot/dashboard](https://app.cline.bot/dashboard).
### ClinePass
- Flat **$9.99/month** subscription
- 2-5x API rate limits for longer agent sessions
- Curated open coding models including GLM, Kimi, DeepSeek, and MiMo
Subscribe from the [ClinePass dashboard](https://app.cline.bot/dashboard/subscription?personal=true), then select **ClinePass** as your provider in Cline. See the [ClinePass guide](/getting-started/clinepass) for included models and reference pricing.
### BYOK (cloud + local)
### Cloud Providers
| Provider | Best For | Setup Guide |
|----------|----------|-------------|
| **OpenRouter** | Multiple models, competitive pricing | [Setup](/provider-config/openrouter) |
| **Anthropic** | Direct Claude access | [Setup](/provider-config/anthropic) |
| **Claude Code** | Claude Max/Pro subscription | [Setup](/provider-config/anthropic) |
| **OpenAI** | GPT models | [Setup](/provider-config/openai) |
| **Google Gemini** | Gemini models | [Setup](/provider-config/google-gemini) |
| **AWS Bedrock** | Enterprise | [Setup](/provider-config/aws-bedrock/api-key) |
| **DeepSeek** | Great value | [Setup](/provider-config/deepseek) |
### Local Models
Run models on your own hardware for complete privacy and zero per-request costs.
| Provider | Best For | Setup Guide |
|----------|----------|-------------|
| **Ollama** | CLI-based local runtime | [Setup](/running-models-locally/overview#runtime-options) |
| **LM Studio** | GUI-based local runtime | [Setup](/running-models-locally/overview#runtime-options) |
Local models require sufficient hardware (especially GPU memory). See [Running Models Locally](/running-models-locally/overview) for requirements.
## CLI Setup
```bash
# Authenticate from the terminal
cline auth
# Shorthand
cline a
```
Runs the same auth flow as IDE setup.
## Troubleshooting
| Issue | Fix |
|-------|-----|
| "Unauthorized: Please sign in" | Session expired. Click **Sign In** to re-authenticate. |
| Browser doesn't open | Check default browser settings. Copy the URL from the Cline output panel manually. |
| Frequent re-authentication | Check org security policies. Ensure you're not clearing IDE secrets. Try a full sign-out/sign-in. |
| Can't access organization | Verify membership at [app.cline.bot](https://app.cline.bot). Ask your admin about permissions. Sign out and back in. |