Agent SkillLINUX DO · AI·11 天前

IDEA通过ACP接入本地Claude Code实现Vibe Coding

原标题：idea如何使用Claude Code的本地配置，在Ai Assistant通过ACP接入中转站

速览

本文详细演示了如何在IntelliJ IDEA中利用ACP协议接入本地安装的Claude Code。通过配置settings.json和acp.json文件，开发者可以将Claude Code作为自定义Agent集成到IDEA的AI Assistant中。该方案支持使用中转站代理，最终实现高效的Vibe Coding体验。

AI 深度解读

背景

在当前的软件开发工作流中，集成人工智能助手已成为提升效率的关键手段。JetBrains 旗下的 IntelliJ IDEA 推出了内置的 AI Assistant 功能，旨在为开发者提供代码生成、重构及问答等智能支持。与此同时，Anthropic 推出的 Claude Code 作为一个强大的本地 AI 编程代理，因其卓越的代码理解和生成能力受到广泛关注。

然而，由于网络环境限制或 API 访问权限问题，许多国内开发者无法直接调用 Anthropic 的原生 API。为了解决这一痛点，社区涌现出多种“中转站”服务，用于代理请求并降低访问门槛。本文分享了一种特定的技术路径：通过配置本地环境变量和 ACP（Agent Client Protocol），将经过中转站认证的 Claude Code 接入 IDEA 的 AI Assistant 中，从而实现“Vibe Coding”（一种强调直觉和流畅交互的编程体验）的高效开发模式。

核心内容

该教程详细阐述了如何在 Windows 环境下，将本地安装的 Claude Code 与 IDEA 的 AI Assistant 通过 ACP 协议进行桥接。整个过程分为基础准备、环境配置和接入操作三个主要阶段。

1. 基础准备 首先，开发者需要在本地计算机上安装好 Claude Code 客户端。其次，确保使用的 IntelliJ IDEA 版本已内置或安装了 AI Assistant 插件。高版本的 IDEA 通常自带 AI Assistant，无需额外安装。

2. 环境配置：Claude Code 侧 配置的核心在于修改 Claude Code 的全局设置文件，以指向特定的 API 中转站。

文件路径：在 Windows 系统中，配置文件位于 C:\Users\【你的用户名】\.claude\settings.json。
配置内容：在 settings.json 中添加或修改 env 字段。
- ANTHROPIC_BASE_URL：设置为中转站提供的 API 地址。
- ANTHROPIC_AUTH_TOKEN：填入从中转站获取的有效 API Key（如示例中的 sk-cbfX7poXE5mjLl**************）。
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：设置为 "1"，以禁用非必要的后台流量，提升隐私性或减少干扰。
建议：教程推荐使用 ccswitch 工具来更方便地管理不同的中转站配置切换。

3. 环境配置：IDEA 侧 在 IDEA 中，需要通过 ACP 协议注册本地 Agent。

入口：在 AI Assistant 对话框右上角点击 option 按钮（三个竖直的点图标）。
操作：选择 Add customer Agent（添加自定义代理），进入 acp.json 配置界面。
配置内容：添加如下 JSON 配置，定义名为 "Claude Code Local" 的代理服务器：
```
{
  "default_mcp_settings":{},
  "agent_servers": {
    "Claude Code Local": {
      "command": "npx.cmd",
      "args": [
        "@agentclientprotocol/claude-agent-acp"
      ],
      "env": {
        "ACP_PERMISSION_MODE": "bypassPermissions"
      },
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}
```
- command：指定执行命令为 npx.cmd。
- args：调用 @agentclientprotocol/claude-agent-acp 包。
- env：设置 ACP_PERMISSION_MODE 为 bypassPermissions，以绕过权限检查，确保流程顺畅。
- use_idea_mcp 和 use_custom_mcp：均设为 true，以启用 IDEA 的 MCP 支持和自定义 MCP 配置。

4. 启用与使用 完成上述配置后，重启 IDEA 使配置生效。在 AI Assistant 中选择刚刚添加的 Claude Code Local 代理，即可使用本地配置的 Claude Code 能力进行代码交互。

关键要点

中转站必要性：由于直接访问 Anthropic API 存在网络障碍，配置 ANTHROPIC_BASE_URL 指向可信的中转站是实现本地调用的前提。
配置文件位置：Claude Code 的配置存储在用户目录下的 .claude\settings.json，需确保路径正确且 JSON 格式无误。
ACP 协议的作用：ACP（Agent Client Protocol）是连接 AI 代理与 IDE 的标准协议，通过 acp.json 定义代理行为，实现了 Claude Code 与 IDEA AI Assistant 的解耦与集成。
权限绕过：在 acp.json 中设置 ACP_PERMISSION_MODE: "bypassPermissions" 是关键步骤，可避免因权限验证失败导致的连接中断。
工具推荐：对于需要频繁切换不同中转站或 API Key 的用户，使用 ccswitch 等管理工具比手动修改 JSON 文件更为便捷和安全。
重启生效：IDEA 的配置更改（特别是 Agent 注册）通常需要重启 IDE 才能被正确加载。

意义与影响

这一配置方案为国内开发者提供了一条低成本、高效率接入顶级 AI 编程能力的路径。

突破访问壁垒：通过中转站和 ACP 桥接，开发者无需复杂的网络代理配置即可在 IDE 内部直接使用 Claude Code 的强大功能，降低了技术门槛。
提升开发体验：将 Claude Code 接入 IDEA AI Assistant，使得开发者可以在熟悉的 IDE 环境中享受“Vibe Coding”的流畅体验，无需在编辑器、终端和浏览器之间频繁切换。
标准化集成：利用 ACP 协议而非私有插件，展示了 AI 工具与 IDE 集成的标准化趋势。这种基于协议的方式更具通用性，未来可能支持更多类型的 AI 代理接入。
社区驱动创新：此类分享源于 LINUX DO 等开发者社区，体现了开源社区在解决工具链痛点、共享最佳实践方面的活力，推动了 AI 辅助编程工具的普及和优化。

查看原文 →linux.do

IDEA通过ACP接入本地Claude Code实现Vibe Coding

速览

AI 深度解读

背景

核心内容

关键要点

意义与影响

相关推荐