Fix failing workflows with Claude Code, directly from the CircleCI UI

Ecosystem
1

We have added a new way to triage and fix failing pipelines right from the CircleCI UI, using your local coding agent.

When a workflow fails, you can now click the wrench icon on the pipeline run page and select Fix with Claude Code.

Screenshot 2026-08-06 at 12.01.41 p.m.
Screenshot 2026-08-06 at 12.01.41 p.m.1618×357 48.4 KB

This opens your default terminal with Claude Code already initiated and pre-loaded with specialized instructions to diagnose the failure.

Here is how it works:

  1. Navigate to a pipeline run in the CircleCI UI.
  2. Click the wrench icon (:wrench:) on a failing workflow.
  3. Select Fix with Claude Code.
  4. Claude Code opens in your terminal, checks for the CircleCI CLI, and runs circleci run get <pipeline-id> --failure-report to pull condensed diagnostic output for every failed step.
  5. Hit Enter
  6. Claude Code reviews the output, identifies the root cause, and produces a fix so your pipeline passes.

This feature builds on the circleci run get --failure-report CLI flag we shipped recently, and brings the full triage-to-fix workflow into a single click from the UI.

Prerequisites:

2

We have expanded where the Fix with Claude Code option appears in the CircleCI UI. You can now access it from two additional surfaces:

From the Pipelines page:

  1. Navigate to your project’s Pipelines page.
  2. Find a failing workflow in the workflows list.
  3. Click the wrench icon (:wrench:) on the failing workflow row.
  4. Select Fix with Claude Code.

image
image3222×1184 405 KB

From inside a failing workflow:

  1. Click into a failing workflow from a pipeline run.
  2. In the workflow header toolbar (next to Rerun and Insights), click the Fix dropdown.
  3. Select Fix with Claude Code.

image
image3234×776 243 KB

3

Update: Copy Fix Prompt, one click from the CircleCI UI

We have added a Copy Fix Prompt button to the CircleCI UI that copies a ready-to-use diagnostic prompt to your clipboard.

How to use it

  1. Navigate to a failing workflow in the CircleCI UI.
  2. Select the wrench icon (:wrench:).
  3. Choose Copy Fix Prompt.
  4. Paste the prompt into your preferred AI coding agent — Cursor, Windsurf, GitHub Copilot, Claude Code, or any tool that accepts a prompt.

The prompt uses the CircleCI CLI to pull a condensed failure report for the run. If the CLI is not installed, the prompt guides your agent through installation first.

Where to find it

Copy Fix Prompt appears in the wrench icon dropdown alongside Fix with Claude Code and Fix with CircleCI on three surfaces:

  • Pipelines page — failing workflow rows
  • Run view — workflow header toolbar
  • Run view — job right pane

What the prompt does

The copied prompt instructs your agent to:

  1. Check for the CircleCI CLI and install it if needed.
  2. Run circleci run get --failure-report to pull condensed failure output. See more.
  3. Diagnose the failure and suggest a fix.