关键词

AI 代码助手Claude Code 集成编程自动化文件与终端交互LLM上下文服务

项目简介

'claude-code-acp' 是一个用于将 Anthropic 的 Claude Code AI 与遵循 Agent Client Protocol (ACP) 的客户端（如 Zed 编辑器）连接起来的适配器。它充当一个桥梁，使 Claude Code AI 能够通过 ACP 客户端的能力执行文件操作和终端命令，并通过内置的 MCP 服务器提供这些功能。

主要功能点

  • 代码助手集成: 将 Claude Code AI 整合到 ACP 兼容的开发环境中，作为智能代码助手。
  • 文件系统交互: 允许 Claude AI 读取、写入和编辑项目中的文件内容。
  • 终端命令执行: 支持 Claude AI 执行 Bash 命令，包括交互式和后台运行的终端任务。
  • 权限管理: 提供工具调用权限请求机制，确保用户对 AI 执行的任何敏感操作（如文件修改、命令执行）拥有控制权。
  • 会话管理: 支持多会话管理和模式切换，例如允许用户选择自动接受文件编辑权限或在“计划模式”下仅进行分析而不执行操作。

安装步骤

  1. 确保您的系统已安装 Node.js (v18+) 和 npm。
  2. 通过 npm 全局安装此适配器： 
    npm install -g @zed-industries/claude-code-acp
  3. 您需要一个有效的 Anthropic Claude API 密钥，用于认证 Claude Code AI 服务。

服务器配置

'claude-code-acp' 本身是一个实现了 Agent Client Protocol (ACP) 的代理程序，它被 ACP 兼容客户端（如 Zed 编辑器）启动和管理。在此适配器内部，它会启动自己的 MCP 服务器（包括一个基于 SDK 的 MCP 服务器和一个基于 HTTP 的 MCP 权限服务器），并将这些 MCP 服务器的信息提供给底层的 Claude Code SDK 使用。

因此，用户在使用时，主要是配置 ACP 客户端 如何启动 'claude-code-acp' 这个代理。ACP 客户端会把 'claude-code-acp' 作为一个外部代理来连接，并为其提供必要的启动命令和环境变量。

以下是一个 ACP 客户端配置 'claude-code-acp' 的示例，用户通常在客户端的 AI 代理设置中进行此类配置：

{
  "name": "Claude Code (ACP)",
  "command": "claude-code-acp",
  "args": [],
  "env": [
    { "name": "ANTHROPIC_API_KEY", "value": "sk-您的AnthropicAPI密钥" }
    // 根据需要添加其他环境变量，例如代理设置等。
  ]
}
  • 'name': 为此 AI 代理连接起一个易于识别的名称，例如 "Claude Code (ACP)"。
  • 'command': 指定启动 'claude-code-acp' 程序的命令行命令。如果已通过 'npm install -g' 全局安装，通常为 'claude-code-acp'。
  • 'args': 启动命令的额外参数。此适配器通常不需要特定的命令行参数，所以可以留空数组 '[]'。
  • 'env': 重要的环境变量配置。其中 'ANTHROPIC_API_KEY' 必须设置为您的 Anthropic Claude API 密钥，用于认证。

基本使用方法

  1. 在 ACP 兼容的客户端中（例如 Zed 编辑器），打开 AI 代理或相关面板。
  2. 选择“新建 Claude Code 对话”或类似选项，客户端将使用上述配置启动 'claude-code-acp' 适配器。
  3. 在对话中，您可以直接与 Claude AI 交流，它将能够利用适配器提供的工具（如读取文件、执行终端命令、修改代码）与您的项目进行交互。
  4. 当 Claude AI 提议执行文件操作或终端命令时，客户端界面会提示您进行审核，您可以选择允许、拒绝或设置特定权限模式（如“总是允许编辑”）。

信息

分类

开发者工具

访问项目