Claude Code 在 JetBrains IDE 的用户指南

Claude Code 是由 Anthropic 推出的智能编码工具，作为全球最强大的编程助手之一，Claude Code 提供了专门的 JetBrains IDE 插件，支持包括 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm 和 Android Studio 在内的整个 JetBrains IDE 系列。通过结合 AceData Cloud 的代理服务，用户可以更高效地配置和使用 Claude Code。

环境准备/前置条件

在开始之前，请确保你已经具备以下前置条件：

安装了支持的 JetBrains IDE。
访问互联网以获取 Claude Code 的 API 凭证。
安装了 Claude Code CLI。

详细步骤

申请使用 Claude Code

首先，访问 Claude Messages 服务页面，点击"获取"按钮以获取请求所需的凭证：

如果你尚未登录或注册，将自动重定向到登录页面。登录或注册后，页面会自动返回。

首次申请用户还可以体验免费的配额，使用 Claude Code 服务。

支持的 IDE

Claude Code 插件支持以下 JetBrains IDE：

IDE	适用语言/场景
IntelliJ IDEA	Java, Kotlin, Scala 等
PyCharm	Python
WebStorm	JavaScript, TypeScript
GoLand	Go
PhpStorm	PHP
Android Studio	Android 开发
其他	大多数 JetBrains IDE 均受支持

安装

前置条件

首先确保安装了 Claude Code CLI，可以通过以下命令进行安装：

bash 复制代码

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# 或使用 Homebrew
brew install claude-code

安装完成后，可以通过以下命令验证：

bash 复制代码

claude --version

安装插件

打开 JetBrains IDE。
进入设置 → 插件 → 市场。
搜索 Claude Code。
点击安装。
重启 IDE。

你也可以直接访问 JetBrains Marketplace 进行在线安装。

注意 : 插件安装后需要完全重启 IDE（可能需要多次重启）才能生效。

配置 AceData Cloud API

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

第一步：创建 config.json

为 Claude Code 创建配置文件：

系统	路径
macOS / Linux	`~/.claude/config.json`
Windows	`C:\Users\{username}\.claude\config.json`

在此文件中写入以下内容并保存：

json 复制代码

{
  "primaryApiKey": "self"
}

macOS / Linux 的快速创建命令：

bash 复制代码

mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json

第二步：配置环境变量

方法 1：在 Shell 配置文件中设置（推荐）

在你的 ~/.zshrc 或 ~/.bashrc 中添加以下内容，将 {token} 替换为你的 API 令牌：

bash 复制代码

# AceData Cloud - Claude Code 代理配置
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

修改后执行 source ~/.zshrc 使配置生效，然后重启 JetBrains IDE。

方法 2：在 Claude Code settings.json 中设置

编辑 ~/.claude/settings.json（如果不存在则创建）：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

提示 : API 令牌可以在 AceData Cloud 控制台中查看。

基本使用

从 IDE 集成终端启动

打开 JetBrains IDE 的集成终端并运行：

bash 复制代码

claude

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

从外部终端连接

如果在外部终端中运行 Claude Code，可以使用 /ide 命令连接到 JetBrains IDE：

bash 复制代码

claude
> /ide

确保从与 IDE 项目根目录相同的路径启动 Claude，以便 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 共享。

插件设置

可以在设置 → 工具 → Claude Code $Beta$ 中进行配置：

设置	描述
Claude 命令	自定义 Claude 命令路径（例如 `/usr/local/bin/claude`）
启用自动更新	自动检查并安装插件更新
启用使用 Option+Enter	在 macOS 上使用 Option+Enter 在提示框中插入新行

WSL 用户配置

如果在 WSL 环境中使用，请将 Claude 命令设置为：

复制代码

wsl -d Ubuntu -- bash -lic "claude"

（将 Ubuntu 替换为你的 WSL 发行版名称）

常见问题

如果连接失败，该怎么办？

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

如果插件无法工作怎么办？

确保 Claude Code 从项目根目录运行。
检查插件是否在 IDE 设置中启用。
完全重启 IDE（可能需要多次重启）。
如果使用远程开发模式，请确保插件已安装在远程主机上（设置 → 插件（主机））。

IDE 未被检测到？

确认插件已安装并启用。
重启 IDE。
确保 Claude Code 在集成终端中运行。
WSL 用户请参考 WSL 故障排除指南。

命令未找到

如果点击 Claude 图标提示"命令未找到"：

确认 CLI 是否安装：which claude。
在插件设置中配置 Claude 命令的完整路径。
WSL 用户使用上述 WSL 命令格式。

如何检查剩余配额？

总结

本文介绍了如何在 JetBrains IDE 中配置和使用 Claude Code，通过 AceData Cloud 的代理服务，开发者可以更高效地进行编程。希望这篇指南对你有所帮助，祝你编程愉快！

📖 Claude Code JetBrains 官方文档
🔧 AceData Cloud Claude Code 服务
💬 如有任何问题，欢迎通过平台客服与我们联系。

技术标签：#ClaudeCode #JetBrains #AceDataCloud #编程助手 #IDE插件