当前位置：首页 > news >正文

Claude Code 在 JetBrains IDE 的用户指南

news 2026/5/14 16:07:56

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，可以通过以下命令进行安装：

# macOS / Linux / WSL curl -fsSL https://claude.ai/install.sh | bash # 或使用 Homebrew brew install claude-code

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

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`

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

{ "primaryApiKey": "self" }

macOS / Linux 的快速创建命令：

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

第二步：配置环境变量

方法 1：在 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。

方法 2：在 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，以便 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 在提示框中插入新行