跳转到主要内容
Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具，也被称为世界最强编程 Agent 之一。Claude Code 提供了 JetBrains IDE 专用插件，支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Android Studio 等全系列 JetBrains IDE。 本文档主要介绍如何通过 AceData Cloud 的代理服务，在 JetBrains IDE 中配置和使用 Claude Code。

​
申请流程

要使用 Claude Messages 服务页面，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。 如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：Claude Messages 服务页面 →

​
支持的 IDE

Claude Code 插件支持以下 JetBrains IDE：
IDE适用语言/场景
IntelliJ IDEAJava、Kotlin、Scala 等
PyCharmPython
WebStormJavaScript、TypeScript
GoLandGo
PhpStormPHP
Android StudioAndroid 开发
其他大多数 JetBrains IDE 均支持

​
安装

​
前提条件

Claude Code JetBrains 插件依赖 Claude Code CLI，请先确保已安装 CLI： 
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# 或使用 Homebrew
brew install claude-code
安装完成后可以验证： 
claude --version

​
安装插件

JetBrains Marketplace 中的 Claude Code 插件
  1. 打开 JetBrains IDE
  2. 进入 Settings → Plugins → Marketplace
  3. 搜索 Claude Code
  4. 点击 Install 安装插件
  5. 重启 IDE
或者直接访问 JetBrains Marketplace 在线安装。
重要：安装插件后需要完全重启 IDE（可能需要重启多次）才能生效。

​
配置 AceData Cloud API

Claude Code JetBrains 插件通过集成终端运行 claude 命令，因此环境变量配置方式与 CLI 相同。

​
步骤一：创建 config.json

创建 Claude Code 的配置文件：
系统路径
macOS / Linux~/.claude/config.json
WindowsC:\Users\{用户名}\.claude\config.json
在该文件中写入以下内容并保存： 
{
  "primaryApiKey": "self"
}
macOS / Linux 快速创建命令： 
mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json

​
步骤二：配置环境变量

方式一：在 Shell 配置文件中设置（推荐） 将以下内容添加到你的 ~/.zshrc 或 ~/.bashrc 中，将 {token} 替换为你的 API 令牌： 
# AceData Cloud - Claude Code 代理配置
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
修改后执行 source ~/.zshrc 使配置生效，然后重启 JetBrains IDE。 方式二：在 Claude Code settings.json 中设置 编辑 ~/.claude/settings.json（如果不存在则创建）： 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
提示：API 令牌可在 AceData Cloud 控制台 中查看。

​
基本使用

​
从 IDE 内部终端启动

打开 JetBrains IDE 的集成终端，运行： 
claude
在 IDE 的集成终端中运行时，所有集成功能（Diff 视图、选择上下文等）会自动激活。

​
从外部终端连接

如果你在外部终端中运行 Claude Code，可以使用 /ide 命令连接到 JetBrains IDE： 
claude
> /ide
确保从 IDE 项目根目录相同的路径启动 Claude Code，这样 Claude 才能访问同一批文件。

​
快捷键

快捷键功能
Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux）快速打开 Claude Code
Cmd+Option+K（Mac）/ Alt+Ctrl+K（Windows/Linux）插入文件引用（如 @File#L1-99）

​
集成功能

Claude Code JetBrains 插件提供以下集成功能：
  • Diff 视图：代码变更直接在 IDE 的 Diff 查看器中展示
  • 选择上下文：当前选中的代码和标签页会自动共享给 Claude
  • 文件引用：使用快捷键快速引用文件和行号
  • 诊断共享：IDE 中的 Lint、语法错误等诊断信息自动共享给 Claude

​
插件设置

在 Settings → Tools → Claude Code [Beta] 中可以配置：
设置说明
Claude command自定义 Claude 命令路径（如 /usr/local/bin/claude）
Enable automatic updates自动检查并安装插件更新
Enable using Option+EntermacOS 下使用 Option+Enter 在提示框中换行

​
WSL 用户配置

如果在 WSL 环境中使用，需要将 Claude command 设置为： 
wsl -d Ubuntu -- bash -lic "claude"
（将 Ubuntu 替换为你的 WSL 发行版名称）

​
常见问题

​
连接失败怎么办？

  1. 检查 ~/.claude/config.json 文件是否正确创建
  2. 确认环境变量已正确设置
  3. 确认 API 令牌有效（可在 控制台 查看）
  4. 重启 JetBrains IDE 后重试

​
插件不工作？

  1. 确保从项目根目录运行 Claude Code
  2. 检查插件是否在 IDE 设置中启用
  3. 完全重启 IDE（可能需要多次重启）
  4. 如果使用远程开发模式，确保插件安装在远程主机（Settings → Plugin (Host)）

​
IDE 未被检测到？

  1. 确认插件已安装并启用
  2. 重启 IDE
  3. 确保在集成终端中运行 Claude Code
  4. WSL 用户请参阅 WSL 排障指南

​
command not found

如果点击 Claude 图标提示 “command not found”：
  1. 确认 CLI 已安装：which claude
  2. 在插件设置中配置 Claude 命令的完整路径
  3. WSL 用户使用上述 WSL 命令格式

​
如何查看剩余额度？

登录 AceData Cloud 控制台，即可查看当前账户的剩余额度和使用情况。

​
了解更多