Lzh on GitHub

Claude Code Provider

Claude Code 提供程序允许您通过 Anthropic 的官方 **CLI（命令行界面）**而不是 Web API 来使用他们的 Claude 模型。这使得您可以直接从 Roo Code 访问您的 Claude Max 订阅。

Claude Code 提供程序允许您通过 Anthropic 的官方 **CLI（命令行界面）**而不是 Web API 来使用他们的 Claude 模型。这使得您可以直接从 Roo Code 访问您的 Claude Max 订阅。

设置说明
在使用 Claude Code 提供程序之前，请确保您已完成以下步骤：
  1. 安装 Claude CLI: 从 Anthropic 的文档 下载并安装官方命令行工具。
  2. 验证设置: 运行 claude --version 以确认 CLI 正在工作。这确保了 Roo Code 可以找到并使用该可执行文件。
  3. 在 Roo Code 中配置:
  • 转到 Roo Code 设置并选择“Claude Code”作为您的 API 提供程序。
  • 如果您将 CLI 安装在自定义位置，请将“Claude Code Path”设置为完整的可执行文件路径（例如，/usr/local/bin/claude）。否则，您可以将其留空。
  • 从可用选项列表中选择您想要的模型。
配置完成后，Roo Code 将使用您本地的 Claude CLI 安装来与 Anthropic 的模型进行交互，从而利用您现有的订阅。

环境变量使用

与 Anthropic 的其他 SDK 一样，claude 命令行工具可以使用 ANTHROPIC_API_KEY 环境变量进行身份验证。这是在非交互式环境中授权 CLI 工具的常用方法。如果您的系统上设置了此环境变量，claude 工具可能会使用它进行身份验证，而不是交互式 /login 方法。当 Roo Code 执行该工具时，它将准确地反映出正在使用 API 密钥，因为这是 claude CLI 本身的基础行为。

主要功能

  • 直接 CLI 访问: 使用 Anthropic 的官方 Claude CLI 工具进行模型交互。
  • 高级推理: 完全支持 Claude 的思考模式和推理能力。
  • 成本透明: 显示由 CLI 报告的确切使用成本。
  • 灵活配置: 与您现有的 Claude CLI 设置配合使用。

为什么使用此提供程序？

  • 无需 API 密钥: 使用您现有的 Claude CLI 身份验证。
  • 成本优势: 利用 CLI 订阅费率和透明的成本报告。
  • 最新功能: 访问 CLI 中发布的新 Claude 功能。
  • 高级推理: 完全支持 Claude 的思考模式。

它是如何工作的

Claude Code 提供程序的工作原理如下：
  • 运行命令: 使用您的提示执行 claude CLI 命令。
  • 处理输出: 使用高级解析器分块处理 CLI 的 JSON 输出。
  • 处理推理: 在可用时捕获并显示 Claude 的思考过程。
  • 跟踪使用情况: 报告由 CLI 提供的令牌使用和成本。
该提供程序与 Roo Code 的界面集成，在幕后使用 Claude CLI 的同时为您提供与其他提供程序相同的体验。

配置

Claude Code 路径

  • 设置: claudeCodePath
  • 描述: 您的 Claude CLI 可执行文件的路径。
  • 默认: claude（假设它在您的系统 PATH 中）。
  • 何时更改: 如果您将 Claude CLI 安装在自定义位置。
  • 自定义路径示例:
    • macOS/Linux: /usr/local/bin/claude 或 ~/bin/claude

最大输出令牌

  • 默认: 16,384 个令牌（16k）- 从以前的 8k 默认值增加。
  • 环境变量: CLAUDE_CODE_MAX_OUTPUT_TOKENS
  • 描述: 控制 Claude 在单个响应中可以生成的最大令牌数。
  • 何时更改: 如果您需要更长的响应，或者出于成本/性能原因想要限制输出长度。
  • 配置示例:
    • export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768 // 设置为 32k 令牌

支持的模型

Claude Code 提供程序支持这些 Claude 模型：
  • Claude Opus 4.1（能力最强）
  • Claude Opus 4
  • Claude Sonnet 4（最新，推荐）
  • Claude 3.7 Sonnet
  • Claude 3.5 Sonnet
  • Claude 3.5 Haiku（响应快）
可用的具体模型取决于您的 Claude CLI 订阅和计划。

输出令牌限制

Claude Code 提供程序现在默认为 16,384 个（16k）最大输出令牌，允许更长、更完整的响应。这对于以下情况特别有用：
  • 生成大型代码文件
  • 详细的解释和文档
  • 复杂的重构操作
  • 多文件更改
如果您的用例需要不同的限制，您可以使用 CLAUDE_CODE_MAX_OUTPUT_TOKENS 环境变量来自定义此限制。

常见问题

“我需要这个提供程序的 Claude API 密钥吗？”
  • 通常不需要。您可以使用 claude 应用程序中的 /login 命令进行交互式身份验证。
  • 然而，如果设置了 ANTHROPIC_API_KEY 环境变量，Claude CLI 可能会使用它进行身份验证。请参阅上面的警告了解详细信息。
“我如何安装 Claude CLI？”“为什么我要使用这个而不是常规的 Anthropic 提供程序？”
  • 根据您的订阅，可能具有潜在的成本优势。
  • “如果 CLI 不在我的 PATH 中怎么办？”
    • 在 Claude Code Path 设置中设置自定义路径。
    • 指向您安装 CLI 的完整路径。