diff --git a/docs/providers/claude-code.md b/docs/providers/claude-code.md deleted file mode 100644 index d2b0325a..00000000 --- a/docs/providers/claude-code.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -sidebar_label: Claude Code -description: Access Claude AI models through the official CLI in Roo Code. No API keys needed, supports advanced reasoning and transparent cost tracking. -keywords: - - claude code - - claude cli - - roo code - - api provider - - claude max - - no api key - - claude reasoning - - claude thinking mode ---- - -# Claude Code Provider - -The Claude Code provider allows you to use Anthropic's Claude models through their official CLI (Command Line Interface) instead of the web API. This provides direct access to your Claude Max subscription right from Roo Code. - -:::info Setup Instructions -Before using the Claude Code provider, ensure you have completed the following steps: - -1. **Install Claude CLI**: Download and install the official command-line tool from [Anthropic's documentation](https://docs.anthropic.com/en/docs/claude-code/setup). -2. **Authenticate**: Run `claude` in your terminal to start the application. Once the application is running, type `/login` to sign in to your Anthropic account. This step is required to grant Roo Code access to your Claude subscription. -3. **Verify Setup**: Confirm the CLI is working by running `claude --version`. This ensures that Roo Code can find and use the executable. -4. **Configure in Roo Code**: - * Go to Roo Code settings and select **"Claude Code"** as your API provider. - * If you installed the CLI in a custom location, set the **"Claude Code Path"** to the full executable path (e.g., `/usr/local/bin/claude`). Otherwise, you can leave it blank. - * Choose your desired model from the list of available options. - -Once configured, Roo Code will use your local Claude CLI installation to interact with Anthropic's models, leveraging your existing subscription. -::: - - -:::warning Environment Variable Usage -The `claude` command-line tool, like other Anthropic SDKs, can use the `ANTHROPIC_API_KEY` environment variable for authentication. This is a common method for authorizing CLI tools in non-interactive environments. - -If this environment variable is set on your system, the `claude` tool may use it for authentication instead of the interactive `/login` method. When Roo Code executes the tool, it will accurately reflect that an API key is being used, as this is the underlying behavior of the `claude` CLI itself. -::: - -**Website:** [https://docs.anthropic.com/en/docs/claude-code/setup](https://docs.anthropic.com/en/docs/claude-code/setup) - ---- - -## How it Works - -The Claude Code provider works by: - -1. **Running Commands**: Executes the `claude` CLI command with your prompts. -2. **Processing Output**: Handles the CLI's JSON output in chunks with advanced parsing. -3. **Handling Reasoning**: Captures and displays Claude's thinking process when available. -4. **Tracking Usage**: Reports token usage and costs as provided by the CLI. - -The provider integrates with Roo Code's interface, giving you the same experience as other providers while using the Claude CLI under the hood. - ---- - -## Configuration - -### **Claude Code Path** -- **Setting**: `claudeCodePath` -- **Description**: Path to your Claude CLI executable. -- **Default**: `claude` (assumes it's in your system PATH). -- **When to change**: If you installed Claude CLI in a custom location. - -**Example custom paths:** -- macOS/Linux: `/usr/local/bin/claude` or `~/bin/claude` - -### **Max Output Tokens** -- **Default**: 16,384 tokens (16k) - increased from previous 8k default -- **Environment Variable**: `CLAUDE_CODE_MAX_OUTPUT_TOKENS` -- **Description**: Controls the maximum number of tokens Claude can generate in a single response. -- **When to change**: If you need longer responses or want to limit output length for cost/performance reasons. - -**Example configuration:** -```bash -export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768 # Set to 32k tokens -``` - ---- - -## Available Models - -The Claude Code provider supports all Claude models available through the official CLI. - -Model availability depends on your Claude CLI subscription and plan. See [Anthropic's CLI documentation](https://docs.anthropic.com/en/docs/claude-code/setup) for details. - ---- - -## Output Token Limits - -The Claude Code provider now defaults to 16,384 (16k) max output tokens, allowing for longer and more complete responses. This is particularly useful for: -- Generating large code files -- Detailed explanations and documentation -- Complex refactoring operations -- Multi-file changes - -You can customize this limit using the `CLAUDE_CODE_MAX_OUTPUT_TOKENS` environment variable if you need different limits for your use case. - ---- - -## Common Questions - -**"Do I need a Claude API key for this provider?"** -- Typically no. You can authenticate interactively using the `/login` command within the `claude` application. -- However, if the `ANTHROPIC_API_KEY` environment variable is set, the Claude CLI may use it for authentication. See the warning above for details. - -**"How do I install the Claude CLI?"** -- Visit [Anthropic's CLI documentation](https://docs.anthropic.com/en/docs/claude-code/setup) for installation instructions -- The CLI handles its own authentication and setup - -**"Why would I use this instead of the regular Anthropic provider?"** -- Potential cost benefits depending on your subscription - -**"What if the CLI isn't in my PATH?"** -- Set a custom path in the Claude Code Path setting -- Point to the full path where you installed the CLI - diff --git a/docs/providers/index.json b/docs/providers/index.json index 882a5b22..5ac59f63 100644 --- a/docs/providers/index.json +++ b/docs/providers/index.json @@ -12,12 +12,6 @@ "extension": true, "cloud": false }, - { - "id": "providers/claude-code", - "title": "Claude Code", - "extension": true, - "cloud": false - }, { "id": "providers/bedrock", "title": "AWS Bedrock", diff --git a/docs/update-notes/v3.21.4.mdx b/docs/update-notes/v3.21.4.mdx index 58076b7b..1b6d85f6 100644 --- a/docs/update-notes/v3.21.4.mdx +++ b/docs/update-notes/v3.21.4.mdx @@ -8,7 +8,7 @@ This release introduces the new Claude Code provider for local CLI integration a ## Use Your Claude Max Subscription with Roo Code -You can now use your Claude Max subscription directly in Roo Code through our new [Claude Code provider](/providers/claude-code) (thanks Cline!) ([#4864](https://github.com/RooCodeInc/Roo-Code/pull/4864), [#5038](https://github.com/RooCodeInc/Roo-Code/pull/5038)): +You can now use your Claude Max subscription directly in Roo Code through our new Claude Code provider (thanks Cline!) ([#4864](https://github.com/RooCodeInc/Roo-Code/pull/4864), [#5038](https://github.com/RooCodeInc/Roo-Code/pull/5038)): - **Leverage Your Existing Subscription**: Connect your Claude Max plan to Roo Code through the Claude CLI - **No Additional API Costs**: Use your subscription benefits instead of paying per-token API rates diff --git a/docs/update-notes/v3.21.mdx b/docs/update-notes/v3.21.mdx index 901df023..960c5953 100644 --- a/docs/update-notes/v3.21.mdx +++ b/docs/update-notes/v3.21.mdx @@ -25,7 +25,7 @@ The Roo Marketplace makes it easy to extend Roo Code's functionality with powerf ## Use Your Claude Max Subscription with Roo Code -You can now use your Claude Max subscription directly in Roo Code through our new [Claude Code provider](/providers/claude-code) (thanks Cline!) ([#4864](https://github.com/RooCodeInc/Roo-Code/pull/4864), [#5038](https://github.com/RooCodeInc/Roo-Code/pull/5038)): +You can now use your Claude Max subscription directly in Roo Code through our new Claude Code provider (thanks Cline!) ([#4864](https://github.com/RooCodeInc/Roo-Code/pull/4864), [#5038](https://github.com/RooCodeInc/Roo-Code/pull/5038)): - **Leverage Your Existing Subscription**: Connect your Claude Max plan to Roo Code through the Claude CLI - **No Additional API Costs**: Use your subscription benefits instead of paying per-token API rates diff --git a/docs/update-notes/v3.28.16.mdx b/docs/update-notes/v3.28.16.mdx index 146a7e58..0283376c 100644 --- a/docs/update-notes/v3.28.16.mdx +++ b/docs/update-notes/v3.28.16.mdx @@ -22,8 +22,6 @@ We've added a 1M‑token context variant of Claude Sonnet 4.5 to Claude Code (th This makes it easier to work across big repos and lengthy traces without losing context. -> **📚 Documentation**: See [Claude Code provider](/providers/claude-code) for model options and context limits. - ## QOL Improvements * Identify Cloud tasks in the extension bridge to improve diagnostics, logging, and future UI behavior ([#8539](https://github.com/RooCodeInc/Roo-Code/pull/8539)) diff --git a/docs/update-notes/v3.34.3.mdx b/docs/update-notes/v3.34.3.mdx index 4277b6aa..c5e7437d 100644 --- a/docs/update-notes/v3.34.3.mdx +++ b/docs/update-notes/v3.34.3.mdx @@ -31,5 +31,5 @@ This release adds Roo Code Cloud as an embeddings provider for codebase indexing ## Provider Updates -* **Claude Opus 4.5 in Claude Code**: Adds the `claude-opus-4-5-20251101` model to the Claude Code provider so you can select it like other Claude code models, with prompt caching support, no image support, and no reasoning effort/budget controls in the UI. ([#9560](https://github.com/RooCodeInc/Roo-Code/pull/9560)) See [Claude Code](/providers/claude-code) for supported models and configuration details. +* **Claude Opus 4.5 in Claude Code**: Adds the `claude-opus-4-5-20251101` model to the Claude Code provider so you can select it like other Claude code models, with prompt caching support, no image support, and no reasoning effort/budget controls in the UI. ([#9560](https://github.com/RooCodeInc/Roo-Code/pull/9560)) * **Claude Opus 4.5 in AWS Bedrock**: Exposes Claude Opus 4.5 through the AWS Bedrock provider so Bedrock users can access the same 200k-context, 8192-token limits, prompt caching, and reasoning capabilities as the existing Claude Opus 4 model (thanks pisicode!). ([#9572](https://github.com/RooCodeInc/Roo-Code/pull/9572)) See [AWS Bedrock](/providers/bedrock) for details on enabling and configuring this model. diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 3e6907cd..a6e86c7c 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -304,6 +304,11 @@ const config: Config = { to: '/', from: ['/providers/human-relay'], }, + // Redirect removed Claude Code provider page + { + to: '/', + from: ['/providers/claude-code'], + }, ], }, ],