# Headless and CI runs

A step of the [Claude Code development environment](https://gradus.kazet.blog/tree/claude-dev-environment) tree on Gradus, in the Tools & reach area: MCP, IDE, headless runs.

Page: https://gradus.kazet.blog/tree/claude-dev-environment/step/headless-runs

Run the assistant non-interactively from scripts and CI, with a fixed prompt, a fixed set of allowed tools and JSON output.

Usually comes after: [MCP servers](https://gradus.kazet.blog/tree/claude-dev-environment/step/mcp-servers).

## Prompt for your AI assistant

```
Add a script that runs Claude Code in non-interactive mode with a fixed prompt (for example summarising the changes in a pull request), restricted to read-only tools, with JSON output. Wire it into the CI workflow as an optional job and document the required API key secret.
```

Every step of the tree: https://gradus.kazet.blog/tree/claude-dev-environment/llms.txt