Integrate Claude directly into your IntelliJ IDEA workflow with this plugin. It adds a dedicated Claude tool window in the right sidebar that runs the claude command in an embedded terminal.
(disclaimer: fully generate with Claude Code)
Features
- Dedicated "Claude Code" tool window in the right sidebar
- Multiple Claude sessions in tabs
- Automatically launches
claudewhen opened - Configurable startup options:
- Continue previous conversation (-c) - enabled by default
- Custom model selection (sonnet, opus, etc.)
- Additional command-line flags
- Quick access to settings from tool window gear menu
- Automatic restoration of tool window state on project restart
- Keyboard shortcut (Ctrl+Shift+N) for new sessions
- Seamless integration with the IDE's terminal
- Custom Claude Code icon in the tool window
Prerequisites
- IntelliJ IDEA 2023.3 or later
- Claude CLI installed and available in your PATH
- Java 17 or later
Installation
From Release (Recommended)
- Download the latest
claude-code-plugin-*.zipfrom the releases - In IntelliJ IDEA, go to Settings/Preferences → Plugins
- Click the gear icon and select Install Plugin from Disk...
- Select the downloaded ZIP file
- Restart IntelliJ IDEA
From Source
- Clone this repository
- Build the plugin:
- The plugin ZIP will be created in
build/distributions/ - Install using the steps above
Usage
- After installation, you'll see a "Claude Code" tab in the right sidebar of your IDE
- Click the tab to open the Claude terminal
- The
claudecommand will start automatically with your configured options - Use Claude as you normally would in a terminal
Multiple Sessions
- Click the gear icon in the tool window and select "New Claude Session"
- Or use the keyboard shortcut Ctrl+Shift+N when the tool window is focused
- Each session runs independently with its own conversation context
Configuration
Access settings in two ways:
- Click the gear icon in the Claude Code tool window → "Claude Settings"
- Go to Settings/Preferences → Tools → Claude Code
Configure startup options:
- Continue previous conversation: Adds
-cflag to continue your last conversation (enabled by default) - Custom model: Select a specific model (sonnet, opus, etc.)
- Additional flags: Add any other command-line options like
--debugor--verbose
Development
Building
# Build the plugin ./gradlew buildPlugin # Run tests ./gradlew test # Run IDE with the plugin for testing ./gradlew runIde
Project Structure
src/main/kotlin/- Plugin source codesrc/main/resources/- Plugin resources (XML configuration, icons)src/test/kotlin/- Unit tests
Testing
The plugin includes unit tests for the main components. Run them with:
Troubleshooting
Claude command not found
If you see an error about claude not being found:
- Ensure Claude is installed:
which claude - If installed via npm, ensure npm bin is in your PATH
- Restart IntelliJ IDEA after installing Claude
Tool window doesn't appear
- Check View → Tool Windows → Claude Code
- Ensure the plugin is enabled in Settings → Plugins
- Try restarting IntelliJ IDEA
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
License
This project is licensed under the MIT License.
Support
For issues or feature requests, please create an issue on GitHub.