Deploy Center Docs Guides GitHub Download

Claude in Deploy Center

Last updated · Edit on GitHub

On this page

Deploy Center can ask Claude three questions about your deploys, with your own Anthropic API key. It is opt-in and off by default.

QuestionWhereWhat is sent
Explain this failuredetail sheet and build log, when the last build failed: Ask Claudethe part of the build log around the first error, masked
Release notes for humans (EN/DE)detail sheet, when commits are waiting: Ask Claudethe titles of the waiting commits and PRs (no authors, no ids)
Is this safe to ship?detail sheet, when commits are waiting: Ask Claudethe diff stats, the risky file names (migrations, env files, lockfiles, build config, workflows), the commit titles, whether auto-deploy is on

Explain this failure also offers Fix with Claude, the same button as on the row: the failed build goes to your Autofix routine (deploys autofix --only <platform> <project>), under the usual caps. Without Autofix set up, it offers the setup instead.

Turning it on#

Settings → Claude in the app → Ask Claude with my own API key. Paste a key from console.anthropic.com, Save, then Verify (it looks up the model with the key; that costs nothing). The Ask Claude menu shows up only when the switch is on and a key is saved.

Privacy#

Command line#

The app runs these; you can too.

pbpaste | deploys ai set-key          # store the key (or set ANTHROPIC_API_KEY)
deploys ai verify                     # the key works and the model is available
deploys ai explain my-project         # why the newest build failed, and the likely fix
deploys ai notes my-project --lang de # plain release notes, English (default) or German
deploys ai ship my-project            # Risk: low, medium or high, and what to check
deploys ai model claude-sonnet-5-5    # claude-opus-5-5 (default), claude-sonnet-5-5, claude-haiku-5-5
deploys ai cap 500000                 # tokens per month
deploys ai status                     # key set (never the key), model, cap, used this month
deploys ai forget-key

Add --json to explain, notes and ship for {text, model, tokens, used, cap}.

The request is the Messages API (anthropic-version: 2026-10-21) at low effort. On Opus and Sonnet the server-side fallback is on (fallbacks: "default"): if a safety classifier declines, the API answers with a fallback model in the same call. A refusal that remains is reported as such.

"What this ships" on every pull request#

examples/claude-pr-ship-check.yml is a GitHub workflow for your app's repo. On each pull request it:

  1. runs deploys changed --json through the Deploy Center action (report only, it never deploys),
  2. lists every project that deploys from this repo with its auto-deploy setting (deploys vercel json / render json) and what already waits on it,
  3. runs Anthropic's Claude Code GitHub Action (anthropics/claude-code-action v1, pinned to a commit) with that list in the prompt; Claude reads the PR diff and posts one comment, What this ships: the projects affected, a risk level, and whether auto-deploy is off (then nothing ships on merge until someone deploys).

Claude may only run gh pr diff, gh pr view and gh pr comment. It needs the secrets ANTHROPIC_API_KEY and VERCEL_TOKEN and/or RENDER_API_KEY, and the workflow permissions contents: read, pull-requests: write, id-token: write. Pull requests from forks get no secrets and are skipped; do not switch it to pull_request_target.

Other ways to use Claude with Deploy Center#