Using Claude Code in JetBrains IDE

Claude Code integrates with IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand, and other IDEs through the official JetBrains plugin. The plugin itself does not include the Claude Code CLI; it runs the native claude command in the IDE integrated terminal, so the CLI must be installed first.

The installation of the plugin, shortcuts, /ide, Claude command, Remote Development, and WSL behavior in this article have been verified against the official Claude Code JetBrains documentation. Content related to 辰汐ai only explains the API address and credential configuration.

1. Obtain 辰汐ai Token

Open the Coding Application in the 辰汐ai Console and create or copy the API Token for that application. Do not place the Token in screenshots, chat records, or Git repositories.

2. Install Claude Code CLI

macOS, Linux, or WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Reopen the terminal and verify:

claude --version

3. Install the Official JetBrains Plugin

You can choose one of the official methods:

Method A: Marketplace

  1. Open Settings / Preferences → Plugins → Marketplace.
  2. Search for and install the Claude Code plugin.
  3. Completely restart the IDE.

Claude Code Plugin in JetBrains Marketplace

Method B: Automatic Installation from Claude Code

Run the following in the terminal of the IDE project directory:

claude

After entering Claude Code, execute:

/ide

If Claude Code detects a running JetBrains IDE that has not yet installed the plugin, /ide will install the plugin and prompt to restart the IDE.

If the plugin cannot find claude, fill in the full path of the executable file in the plugin settings under Claude command. You can first run the following command to locate it:

which claude

4. Configure 辰汐ai

The env field in the official Claude Code Settings accepts specific string values for environment variables; the official documentation does not state that it will expand ${NAME}. Therefore, do not write ${ACEDATACLOUD_API_KEY} in settings.json and assume it will be automatically replaced.

It is recommended to set the credentials in the local environment when starting the IDE.

macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
export ANTHROPIC_AUTH_TOKEN="your Ace Data Cloud API Token"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.acedata.cloud"
$env:ANTHROPIC_AUTH_TOKEN="your Ace Data Cloud API Token"

You must start the JetBrains IDE from the same configured environment or add the variables to your actual local user environment used to start the IDE. After configuration, completely exit and reopen the IDE.

If you choose to write the values into Claude Code Settings, you can only write them into the local private ~/.claude/settings.json or the .claude/settings.local.json that has been ignored by Git, and replace the placeholders with the real Token locally:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud",
    "ANTHROPIC_AUTH_TOKEN": "replace with real Token locally"
  }
}

Do not write the real Token into the team-shared .claude/settings.json and submit it to Git.

If an old ANTHROPIC_API_KEY exists in the same startup environment, please unset it first:

unset ANTHROPIC_API_KEY

5. Usage and Verification

When running claude from the IDE integrated terminal, the plugin will automatically enable IDE integration features. You can also start Claude Code from an external terminal in the project root directory and then execute /ide to connect to the current IDE:

cd /path/to/project
claude

/ide

After a successful connection, Claude Code will display a message like Connected to IntelliJ IDEA.

First, perform a minimal connection verification:

claude -p "Reply only OK"

Then initiate a read-only task from the IDE, for example:

Explain the directory structure of the current project without modifying files.

The main capabilities supported by the official plugin include IDE diff viewer, current selection/tab context, file line number references, and diagnostic information sharing. Common shortcuts:

  • macOS: Cmd+Esc to quickly open; Cmd+Option+K to insert file reference.
  • Windows/Linux: Ctrl+Esc to quickly open; Alt+Ctrl+K to insert file reference.

6. Remote Development and WSL

  • JetBrains Remote Development must have the plugin installed on the remote host: Settings → Plugin (Host).
  • The Claude Code CLI, API environment variables, and project paths in the remote environment must also be configured on the remote host, not on the local UI machine.
  • The discovery of IDE and Claude Code under WSL2 relies on Windows/WSL network connectivity; if /ide cannot detect the IDE, please check the firewall or mirrored networking according to the official Claude Code JetBrains WSL troubleshooting.
  • Do not automatically treat the browser or local Windows OS as the execution environment for remote projects.

Common Issues

Cannot launch Claude Code / command not found

The plugin does not come with the CLI. First, confirm that claude --version is successful; if the IDE's PATH is different, fill in the full path returned by which claude in the Claude command, then restart the IDE.

IDE not detected

Confirm that the official plugin is enabled, Claude Code is started from the same project root directory, and /ide is re-executed in the session. During Remote Development, confirm that the plugin is installed on the Host side.

Returns 401

Confirm that the Token belongs to a usable Coding Application, the IDE process indeed inherits ANTHROPIC_AUTH_TOKEN, and there is no residual old ANTHROPIC_API_KEY.

Model unavailable

The model directory will continue to update. Refer to the exact model ID and validation status in the Coding configuration selector and the real-time model directory, and do not rely on the static model list in the tutorial.

Official References