Claude Code + IntelliJ IDEA Immersive Coding Guide: Setup, Anthropic-Compatible Configuration, Command Workflows, and Engineering Best Practices

Technical Snapshot

Parameter Description
Tool Type AI coding CLI + IDE plugin
Primary Languages Shell / JSON / Markdown
Protocol Anthropic-compatible API protocol
IDE JetBrains IDEA family
Access Method CLI installation + plugin integration
Typical Model qwen3.6-plus
Core Dependencies Homebrew, Claude Code, JetBrains Plugin
Documentation Sources Xuxueli practical guide and Claude official documentation

Claude Code operates as an AI coding partner for real engineering workflows

Claude Code is an AI coding collaboration tool built for engineering scenarios. Its core value lies in understanding project context, following constraints, and participating in real code-change workflows. This article focuses on three areas: Claude Code and IDEA integration, Anthropic-compatible protocol configuration, and command workflows. It addresses common pain points such as poor production adoption of AI coding, context drift, and lack of execution validation. Keywords: Claude Code, IDEA integration, Anthropic protocol.

Claude Code is not just a chat-style assistant. It is a coding agent that understands context at the project level. It can read directories, identify file relationships, follow project rules, and execute changes after a plan is confirmed.

Unlike one-shot code generation, it emphasizes maintainability, standardization, and a validation feedback loop. That makes it well suited for tasks such as dependency upgrades, module refactoring, test completion, and coordinated multi-file changes.

Its core capabilities can be summarized in three points

  • Context awareness: It understands the entire project rather than a single file.
  • Engineering focus: It prioritizes standards, testing, and maintainability.
  • Customizable behavior: You can extend it with Skills, Hooks, and MCP.
# Check the Claude Code version
claude --version

# Update Claude Code
claude update

These commands confirm whether the local CLI is available and whether the version meets the requirements for later configuration.

Anthropic-compatible model services reduce the barrier to adoption

The original article uses a third-party Coding Plan service as an example. In that setup, Alibaba Cloud Bailian provides an Anthropic-compatible interface, allowing Claude Code to connect to an external model service through standard environment variables.

The value of this approach is flexibility. Teams do not need to rely on a single official subscription path. Instead, they can choose model providers and billing plans that better fit compliance and operational requirements.

The key to configuration is a unified environment variable entry point

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3.6-plus",
    "ANTHROPIC_SMALL_FAST_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
    "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
  }
}

This configuration defines authentication, the gateway endpoint, and default model mappings. It is the primary entry point for connecting Claude Code to a compatible service.

In addition to ~/.claude/settings.json, it is also recommended to maintain ~/.claude.json and set hasCompletedOnboarding to true to avoid connection initialization errors during first launch.

The installation and startup flow should stay as short as possible

macOS users can install Claude Code directly with Homebrew. After installation, enter the project directory and run claude. On first launch, you must confirm whether the current directory is trusted.

After authorization, run /status first to verify that the model, Base URL, and API key are configured correctly. This step acts as a health check for the AI coding workflow and should become a standard habit.

# Install Claude Code
brew install --cask claude-code

# Enter the project directory and launch Claude Code
cd path/to/your_project
claude

This flow completes tool installation and project-level session startup. It is the most basic path to adoption.

Common commands determine daily collaboration efficiency

Claude Code uses an engineering-oriented command system. Among the available commands, /plan, /clear, /compact, and /init matter most for long-term collaboration. They map to planning, clearing context, compressing context, and persisting project rules.

In complex tasks, entering planning mode first and waiting for human confirmation can significantly reduce incorrect modifications and large-scale rework.

Recommended commands to master first

/init          # Initialize the project-level CLAUDE.md and persist rules
/status        # Check model and connection status
/model qwen3-coder-next   # Switch the model
/plan          # Plan first instead of modifying code immediately
/compact       # Compress historical context to save window space
/clear         # Clear the session to avoid context contamination

These commands cover initialization, diagnostics, planning, and context governance. Together, they form the minimum closed loop for high-frequency workflows.

IDEA plugin integration brings CLI capabilities into the primary development environment

After installing the Claude Code plugin from the JetBrains Marketplace, you can use the same workflow capabilities directly inside IDEA. For developers who work primarily in an IDE, this is more efficient than constantly switching back to the terminal.

The value of plugin integration goes beyond simple availability. It embeds AI collaboration into code browsing, editing, debugging, and validation, creating a smoother and more immersive programming experience.

Real tasks should follow a plan-first, execute-second interaction model

The original article provides a typical example: upgrading dependency versions in a Maven pom.xml. A good prompt should not ask for direct modification. Instead, it should instruct the agent to analyze dependencies, identify the latest versions, propose the changes, and then wait for confirmation.

This approach elevates AI from an automatic code-writing tool to an auditable implementation assistant. It works well for any task that involves cost, risk, or multi-file impact.

Task: Analyze the dependency versions in the project's pom file and help me upgrade them to the latest versions.
Requirements: Output a detailed plan first, then wait for my confirmation before making any changes.
Acceptance criteria: List the upgrade items, new versions, and potential compatibility risks.

Prompts like this constrain the goal, process, and acceptance criteria at the same time, reducing ambiguous execution.

Engineering best practices determine whether AI coding can scale reliably over time

First, control context. In complex projects, using /compact frequently and referencing specific files with @filename is more effective than endlessly extending the conversation. The more precise the context, the more stable the output.

Second, persist rules. By writing build commands, coding standards, test requirements, and workflow constraints into CLAUDE.md, each session can automatically inherit team knowledge.

Extension capabilities should serve deterministic workflows

MCP is well suited for connecting external services such as web search. Skills are better for defining reusable capability packs. Hooks are ideal for enforced validation, such as automatically running lint checks or tests after file modifications.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

This configuration enables the experimental Agent Teams capability for more complex multi-agent collaboration scenarios.

The ultimate goal is not simply to make AI write code. It is to make AI deliver code according to rules. For that reason, every modification should be followed by testing, compilation, API validation, or screenshot-based verification to create a self-checking feedback loop.

Supporting references and image notes provide additional context

Input image description AI Visual Insight: This image shows the brand logo for the XXL project family. It serves as a site or author project identifier and does not contain technical architecture, UI workflow, or code-level detail. No additional implementation information needs to be extracted from it.

The original article also includes links to the official Claude documentation and the author’s website. These are useful reference points for tracking command changes, feature evolution, and plugin updates.

FAQ

What is the core difference between Claude Code and a typical AI chat-based coding tool?

Claude Code places more emphasis on project-level context understanding, planning before execution, rule compliance, and execution validation. That makes it better suited for real engineering collaboration rather than one-off code generation.

Why should I use /plan before asking AI to modify code directly?

Because the planning phase exposes dependency impact, compatibility risks, and change scope in advance. Confirming the plan before execution can significantly reduce rework.

How can I help Claude Code understand the current project better?

The most effective approach is to maintain CLAUDE.md, reference specific files in prompts, use /compact to retain key memory, and establish a validation loop through Hooks and test commands.

Core summary

This article reconstructs a practical integration approach for Claude Code and IntelliJ IDEA. It covers installation, Anthropic-compatible protocol configuration, common commands, JetBrains plugin integration, task execution patterns, and engineering best practices. The goal is to help teams establish an AI coding workflow that is plannable, executable, and verifiable.