> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code for JetBrains IDE 使用教程

> Claude Code 集成指南 - Ace Data Cloud

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 服务页面](https://platform.acedata.cloud/documents/claude-messages) 点击「Acquire」按钮，获取请求所需要的凭证：

![](https://cdn.acedata.cloud/nyq0xz.png)

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

在首次申请时会有免费额度赠送，可以免费体验 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：

```bash theme={null}
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# 或使用 Homebrew
brew install claude-code
```

安装完成后可以验证：

```bash theme={null}
claude --version
```

### 安装插件

![JetBrains Marketplace 中的 Claude Code 插件](https://cdn.acedata.cloud/de78fd305b.png)

1. 打开 JetBrains IDE
2. 进入 **Settings** → **Plugins** → **Marketplace**
3. 搜索 **Claude Code**
4. 点击 **Install** 安装插件
5. 重启 IDE

或者直接访问 [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) 在线安装。

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

## 配置 AceData Cloud API

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

### 步骤一：创建 config.json

创建 Claude Code 的配置文件：

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

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

```json theme={null}
{
  "primaryApiKey": "self"
}
```

macOS / Linux 快速创建命令：

```bash theme={null}
mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json
```

### 步骤二：配置环境变量

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

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

```bash theme={null}
# 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`（如果不存在则创建）：

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

> **提示**：API 令牌可在 [AceData Cloud 控制台](https://platform.acedata.cloud/console) 中查看。

## 基本使用

### 从 IDE 内部终端启动

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

```bash theme={null}
claude
```

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

### 从外部终端连接

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

```bash theme={null}
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 设置为：

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

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

## 常见问题

### 连接失败怎么办？

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

### 插件不工作？

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

### IDE 未被检测到？

1. 确认插件已安装并启用
2. 重启 IDE
3. 确保在集成终端中运行 Claude Code
4. WSL 用户请参阅 [WSL 排障指南](https://code.claude.com/docs/en/troubleshooting#jetbrains-ide-not-detected-on-wsl2)

### command not found

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

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

### 如何查看剩余额度？

登入 [AceData Cloud 控制台](https://platform.acedata.cloud/console)，即可查看當前帳戶的剩餘額度和使用情況。

## 了解更多

* 📖 [Claude Code JetBrains 官方文檔](https://code.claude.com/docs/en/jetbrains)
* 🔧 [AceData Cloud Claude Code 服務](https://platform.acedata.cloud/documents/claude-messages)
* 💬 如有任何問題，歡迎透過平台客服聯繫我們