Claude Code for JetBrains IDE User Guide

Claude Code is an Agentic Coding tool launched by Anthropic, also known as one of the world's strongest programming agents. Claude Code provides a dedicated plugin for JetBrains IDEs, supporting the entire series of JetBrains IDEs including IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, and Android Studio.

This document mainly introduces how to configure and use Claude Code in JetBrains IDE through the proxy service of AceData Cloud.

Application Process

To use the Claude Messages service page, first go to the Ace Data Cloud Console to obtain your API Token for backup.

If you are not logged in or registered, you will be automatically redirected to the login page inviting you to register and log in, and will return to the current page automatically after completion.

One API Token can call all services on the platform, no need to apply separately for each service. The first application will grant a free quota for a free experience; when the quota is insufficient, you can recharge the general balance in the console.

📘 Complete documentation: Claude Messages Service Page →

Supported IDEs

The Claude Code plugin supports the following JetBrains IDEs:

IDE Applicable Languages/Scenarios
IntelliJ IDEA Java, Kotlin, Scala, etc.
PyCharm Python
WebStorm JavaScript, TypeScript
GoLand Go
PhpStorm PHP
Android Studio Android Development
Others Most JetBrains IDEs are supported

Installation

Prerequisites

The Claude Code JetBrains plugin depends on the Claude Code CLI, please ensure that the CLI is installed first:

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

# Or use Homebrew
brew install claude-code

After installation, you can verify:

claude --version

Install Plugin

Claude Code Plugin in JetBrains Marketplace

  1. Open JetBrains IDE
  2. Go to Settings → Plugins → Marketplace
  3. Search for Claude Code
  4. Click Install to install the plugin
  5. Restart IDE

Or visit JetBrains Marketplace for online installation.

Important: After installing the plugin, you need to completely restart the IDE (may require multiple restarts) for it to take effect.

Configure AceData Cloud API

The Claude Code JetBrains plugin runs the claude command through the integrated terminal, so the environment variable configuration method is the same as the CLI.

Step 1: Create config.json

Create the configuration file for Claude Code:

System Path
macOS / Linux ~/.claude/config.json
Windows C:\Users\{username}\.claude\config.json

Write the following content in this file and save:

{
  "primaryApiKey": "self"
}

Quick creation command for macOS / Linux:

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

Step 2: Configure Environment Variables

Method 1: Set in Shell Configuration File (Recommended)

Add the following content to your ~/.zshrc or ~/.bashrc, replacing {token} with your API token:

# AceData Cloud - Claude Code Proxy Configuration
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

After modification, execute source ~/.zshrc to make the configuration effective, then restart JetBrains IDE.

Method 2: Set in Claude Code settings.json

Edit ~/.claude/settings.json (create if it does not exist):

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

Tip: The API token can be viewed in the AceData Cloud Console.

Basic Usage

Start from the IDE Integrated Terminal

Open the integrated terminal of JetBrains IDE and run:

claude

When running in the IDE's integrated terminal, all integrated features (Diff view, context selection, etc.) will be automatically activated.

Connect from an External Terminal

If you run Claude Code in an external terminal, you can use the /ide command to connect to JetBrains IDE:

claude
> /ide

Make sure to start Claude Code from the same path as the IDE project root so that Claude can access the same batch of files.

Shortcuts

Shortcut Function
Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) Quickly open Claude Code
Cmd+Option+K (Mac) / Alt+Ctrl+K (Windows/Linux) Insert file reference (e.g., @File#L1-99)

Integrated Features

The Claude Code JetBrains plugin provides the following integrated features:

  • Diff View: Code changes are displayed directly in the IDE's Diff viewer
  • Context Selection: The currently selected code and tab will be automatically shared with Claude
  • File Reference: Quickly reference files and line numbers using shortcuts
  • Diagnostic Sharing: Lint, syntax errors, and other diagnostic information in the IDE are automatically shared with Claude

Plugin Settings

You can configure in Settings → Tools → Claude Code [Beta]:

Setting Description
Claude command Custom Claude command path (e.g., /usr/local/bin/claude)
Enable automatic updates Automatically check and install plugin updates
Enable using Option+Enter Use Option+Enter to insert a new line in the prompt on macOS

WSL User Configuration

If using in a WSL environment, set the Claude command to:

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

(Replace Ubuntu with your WSL distribution name)

Frequently Asked Questions

What to do if the connection fails?

  1. Check if the ~/.claude/config.json file is correctly created
  2. Confirm that the environment variables are set correctly
  3. Confirm that the API token is valid (can be viewed in the console)
  4. Retry after restarting JetBrains IDE

What if the plugin does not work?

  1. Ensure Claude Code is run from the project root directory
  2. Check if the plugin is enabled in the IDE settings
  3. Completely restart the IDE (may require multiple restarts)
  4. If using remote development mode, ensure the plugin is installed on the remote host (Settings → Plugin (Host))

IDE not detected?

  1. Confirm that the plugin is installed and enabled
  2. Restart the IDE
  3. Ensure that Claude Code is running in the integrated terminal
  4. WSL users please refer to the WSL Troubleshooting Guide

command not found

If clicking the Claude icon prompts "command not found":

  1. Confirm that the CLI is installed: which claude
  2. Configure the full path of the Claude command in the plugin settings
  3. WSL users use the above WSL command format

How to check the remaining quota?

Log in to the AceData Cloud Console to view the current account's remaining quota and usage.

Learn more