mirror of
https://github.com/cline/cline.git
synced 2026-09-19 02:05:44 +08:00
Tomás Barreiro
b18ad77539
* Create docs * Improve the Claude Code error messages * Replace with remote image
112 lines
5.0 KiB
Plaintext
112 lines
5.0 KiB
Plaintext
---
|
|
title: "Claude Code"
|
|
description: "Use your Claude Max or Pro subscription with Cline instead of paying per token. Learn how to set up and configure the Claude Code provider."
|
|
---
|
|
|
|
**Website:** [https://docs.anthropic.com/en/docs/claude-code/setup](https://docs.anthropic.com/en/docs/claude-code/setup)
|
|
|
|
The Claude Code provider lets you use your existing Claude subscription with Cline. If you have Claude Max or Pro, this means you can use Claude in Cline without paying extra API costs.
|
|
|
|
<Frame>
|
|
<img
|
|
src="https://storage.googleapis.com/cline_public_images/docs/assets/claude-code-use-opus.gif"
|
|
alt="Using the Claude Code provider in Cline with Opus model"
|
|
/>
|
|
</Frame>
|
|
|
|
## Setup
|
|
|
|
First, you'll need to install and authenticate Claude Code on your system:
|
|
|
|
1. **Install Claude Code**: Follow Anthropic's [official setup guide](https://docs.anthropic.com/en/docs/claude-code/setup) to install and authenticate the Claude CLI.
|
|
|
|
2. **Configure in Cline**:
|
|
- Open Cline settings (⚙️ icon)
|
|
- Select **Claude Code** from the **API Provider** dropdown
|
|
- Set the path to your Claude CLI executable (usually just `claude` if it's in your PATH)
|
|
|
|
<Frame>
|
|
<img
|
|
src="https://storage.googleapis.com/cline_public_images/docs/assets/claude-code-setup.gif"
|
|
alt="Setting up the Claude Code provider in Cline"
|
|
/>
|
|
</Frame>
|
|
|
|
<br />
|
|
|
|
<Accordion title="Windows Setup">
|
|
On Windows, Cline supports integrating with Claude Code through WSL.
|
|
Windows doesn't support long commands, and Claude Code only accepts the system prompt through a flag, which means we can't properly prompt Claude through Claude Code. Anthropic is [working on a workaround to streamline this](https://github.com/anthropics/claude-code/issues/3411).
|
|
|
|
1. **Make sure you have WSL set-up**. You can follow [this](https://code.visualstudio.com/docs/remote/wsl#_installation) guide to do it.
|
|
|
|
2. **Open VSCode from WSL** and verify it's properly set-up. You should see an indicator in the bottom left that says "WSL". You can find an image of the indicator [here](https://code.visualstudio.com/docs/remote/wsl#_from-the-wsl-terminal).
|
|
|
|
3. Install Cline within WSL and make sure it shows the following:
|
|
|
|
<Frame>
|
|
<img
|
|
src="https://storage.googleapis.com/cline_public_images/docs/assets/cline_wsl_installed_extension.webp"
|
|
alt="Indicator that an extension is installed on WSL"
|
|
/>
|
|
</Frame>
|
|
|
|
4. Clone or [move](https://stackoverflow.com/a/42586455) your project over to WSL
|
|
|
|
5. Follow the [instructions on how to set up Claude Code normally](#setup), but from the WSL terminal.
|
|
|
|
</Accordion>
|
|
|
|
### Finding your Claude Code path
|
|
|
|
If you're not sure where Claude Code is installed:
|
|
|
|
- **macOS / Linux**: Run `which claude` in your terminal
|
|
- **Windows (Command Prompt)**: Run `where claude`
|
|
- **Windows (PowerShell)**: Run `Get-Command claude`
|
|
|
|
## Supported Models
|
|
|
|
The Claude Code provider supports these models:
|
|
|
|
- `claude-sonnet-4-20250514` (Recommended)
|
|
- `claude-opus-4-20250514`
|
|
- `claude-3-7-sonnet-20250219`
|
|
- `claude-3-5-sonnet-20241022`
|
|
- `claude-3-5-haiku-20241022`
|
|
|
|
## How it works
|
|
|
|
When you use Claude Code with Cline, here's what happens behind the scenes:
|
|
|
|
Cline wraps the Claude Code CLI to handle your requests. Each time you send a message, Cline starts a new `claude` process, sends your conversation, and streams the response back. The AI reasoning comes from Claude Code, but all the actual file editing, terminal commands, and other tools are handled by Cline.
|
|
|
|
The main difference you'll notice is that responses don't stream character-by-character like other providers. Instead, Claude Code processes your full request before sending back the complete response.
|
|
|
|
## Limitations
|
|
|
|
There are a few things to keep in mind with Claude Code:
|
|
|
|
- Images in your messages get converted to text placeholders since Claude Code doesn't support image uploads through the CLI
|
|
- Prompt caching isn't available with this provider
|
|
- Responses don't stream in real-time like other providers
|
|
|
|
## Troubleshooting
|
|
|
|
If you run into issues:
|
|
|
|
**Authentication problems**: Make sure you're logged into Claude Code with your subscription account. Run `claude auth status` to check.
|
|
|
|
**Path issues**: Double-check that the Claude CLI path in Cline's settings is correct. Try running `claude --version` in your terminal to verify it's working.
|
|
|
|
**Still having trouble?** We're actively improving this integration. Report issues on our [GitHub](https://github.com/cline/cline/issues) or ask for help in our [Discord](https://discord.gg/cline).
|
|
|
|
## Usage with subscriptions
|
|
|
|
If you have a Claude Max subscription, your usage in Cline shows up as $0.00 in the billing interface since you're not paying additional API costs. Your usage still counts against your subscription limits, but you won't see per-token charges.
|
|
|
|
For more details about using Claude Code with your subscription, check out Anthropic's documentation:
|
|
|
|
- [Claude Code Setup Guide](https://docs.anthropic.com/en/docs/claude-code/setup)
|
|
- [Using Claude Code with Pro/Max Plans](https://support.anthropic.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan)
|