Using Claude Code with Warp | Notifications & Code Review Setup

What Is Warp — An AI-Native Terminal

Warp is an AI-native terminal for macOS, Linux, and Windows. Beyond command completion and natural-language shell operations, it positions itself as a workbench for launching, managing, and scaling AI coding tools locally or in the cloud. On Anthropic's customer page (https://claude.com/customers/warp), Warp is featured as a company that uses Claude to build its own product, and it is rapidly gaining adoption as an AI development environment for engineers.

The biggest difference from a standard terminal is its built-in UI layer that visualizes agent state. When running Claude Code, rather than text simply scrolling by, the design uses status indicators and notifications so you can tell at a glance what the agent is doing at any moment.

Benefits of Combining Warp with Claude Code

Claude Code is an AI coding tool for the terminal provided by Anthropic, enabling you to understand codebases, run commands, edit files, and perform Git operations using natural language. Combining it with Warp unlocks the following benefits that plain Claude Code alone does not offer.

• Notification support: In-app and desktop notifications arrive whenever command approval or code review is needed
• Rich input editor: A dedicated editor opens for comfortably writing long prompts (Ctrl-G)
• Inline code review: Review comments can be sent directly to Claude Code from Warp's code review panel
• Session management: Agent status is displayed in vertical tabs, and settings can be saved and restored with Tab Configs
• Remote control: Sessions can be shared with team members

Full details on these features are available in the official documentation (https://docs.warp.dev/agent-platform/cli-agents/claude-code).

Prerequisites — What You Need

To set up a Warp × Claude Code environment, you need the following three things in place.

1. Install Warp: Download from warp.dev. Supports macOS, Linux, and Windows.
2. Install Claude Code CLI: Run npm install -g @anthropic-ai/claude-code.
3. Install jq: Used by the plugin for JSON parsing. On macOS run brew install jq; on Linux run sudo apt install jq or sudo dnf install jq.

Once all three are ready, proceed to install the plugin.

Plugin Installation Steps

The Claude Code integration plugin for Warp is published under the MIT license on the official GitHub repository (https://github.com/warpdotdev/claude-code-warp). There are two installation methods: automatic and manual.

Automatic Installation

The easiest approach is automatic installation. If you launch Claude Code in Warp without the plugin, a notification chip appears at the top of the screen, and you can install the plugin with a single click. After installation, restart Claude Code or run /reload-plugins to activate it.

Manual Installation

To install manually from the command line, follow these steps.

1. Add the plugin marketplace (run in terminal):

   claude plugin marketplace add warpdotdev/claude-code-warp
   

2. Install the plugin (run in terminal):

   claude plugin install warp@claude-code-warp
   

3. Restart Claude Code or run /reload-plugins to activate it.

Make sure to run brew install jq (macOS) or apt install jq (Linux) before manual installation. The plugin will not function without jq.

How to Use Notifications

Once the plugin is installed, Claude Code will send notifications to Warp at the following moments.

• Task completion: When work is finished and Claude Code is waiting for the user to confirm
• Awaiting input: When idle and waiting for the next instruction
• Permission request: When asking the user to authorize a tool execution

The notification UI displays the current Git branch name alongside the agent's status, so when running multiple projects simultaneously you can tell at a glance which project's process is waiting.

Notification sounds and desktop notification behavior can be customized from Warp's notification settings. If you are working on something else while a long task runs in the background, enabling desktop notifications prevents you from missing important updates.

Using the Rich Input Editor (Ctrl-G)

When you want to pass a long instruction or large amount of context to Claude Code, standard terminal input makes handling line breaks cumbersome. In Warp, pressing Ctrl-G opens a rich input editor that makes composing multi-line prompts a comfortable experience.

Practical use cases include:

• Writing out detailed specifications paragraph by paragraph
• Pasting code snippets to pass as context
• Organizing work instructions that span multiple files in a list format

Inside the editor, Shift+Enter inserts a newline and Enter sends the prompt. This feature is especially powerful when you need to hand off a long instruction all at once.

Code Review Integration

Warp has a built-in code review panel that lets you send inline comments on diffs directly to Claude Code. Previously, you had to copy review comments into the terminal and paste them — with Warp you can pass feedback directly from the UI.

By selecting code and using the "send to agent" shortcut, you can attach a specific line or block as context. This makes it dramatically easier to convey instructions like "do X with this code."

Session Management and Tab Configuration

Warp's vertical tabs display a status indicator for each process. Whether Claude Code is in a "running," "waiting," or "error" state is indicated by color or symbol, so you can check the state without switching between multiple terminal tabs.

The Tab Configs feature lets you save the settings of a session where Claude Code is running — working directory, environment variables, prompt configuration, and more — so you can instantly recreate the same environment next time you launch. It is ideal for workflows where you "spin up Claude Code on a fixed project" every morning.

The remote control feature lets you share a session with team members for pair-programming-style collaboration.

Under the Hood — What the Plugin Does

For those curious about how the plugin works, here is a technical overview. The plugin communicates with Warp via OSC 777 escape sequences, sending structured JSON payloads to implement the various notifications.

Six hooks are registered.

1. SessionStart: Issues a welcome message when the plugin starts
2. Stop: Extracts input and response from the transcript and sends a notification
3. Notification: Notifies of idle input-waiting state
4. PermissionRequest: Notifies when a tool execution requires permission
5. UserPromptSubmit: Notifies when a prompt is submitted
6. PostToolUse: Notifies when a tool execution completes

The source code is published under the MIT license, so custom modifications are possible.

How to Uninstall

To remove the plugin, follow these steps.

1. Uninstall the plugin (run inside Claude Code):

   /plugin uninstall warp@claude-code-warp
   

2. Remove it from the marketplace as well (run inside Claude Code):

   /plugin marketplace remove claude-code-warp
   

Summary — Warp × Claude Code Development Workflow

Warp enhances the "plain terminal experience" of Claude Code along four axes: notifications, rich input, inline code review, and session management. Even when you are working on something else while a long task runs, completion notifications keep you informed and improve overall productivity.

Setup takes just 2 commands, and with jq in place the environment is ready in minutes. Warp itself can be tried on a free plan (additional features available on paid plans), so the barrier to entry is low for developers who use Claude Code daily. The recommended approach is to first set up an environment where the automatic installation notification chip appears, then experience firsthand what receiving those notifications feels like.