Claude Code for JetBrains IDE 使用教程

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 Code，首先可以到 Claude Messages 服务页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 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 JetBrains 插件依赖 Claude Code CLI，请先确保已安装 CLI：

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

# 或使用 Homebrew
brew install claude-code

安装完成后可以验证：

1	claude --version

安装插件

打开 JetBrains IDE
进入 Settings → Plugins → Marketplace
搜索 Claude Code
点击 Install 安装插件
重启 IDE

或者直接访问 JetBrains Marketplace 在线安装。

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

配置 AceData Cloud API

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

步骤一：创建 config.json

创建 Claude Code 的配置文件：

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

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

1
2
3

{
  "primaryApiKey": "self"
}

macOS / Linux 快速创建命令：

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

步骤二：配置环境变量

方式一：在 Shell 配置文件中设置（推荐）

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

1
2
3

# 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：

1 2	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+Enter	macOS 下使用 Option+Enter 在提示框中换行

WSL 用户配置

如果在 WSL 环境中使用，需要将 Claude command 设置为：

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

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

常见问题

连接失败怎么办？

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

插件不工作？

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

IDE 未被检测到？

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

command not found

如果点击 Claude 图标提示 “command not found”：

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

如何查看剩余额度？

了解更多

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