[DOCS] headless mode documentation does not warn it should not be used from scripts when using a subscription account

Documentation Type

Other

Documentation Location

https://code.claude.com/docs/en/headless

Section/Topic

All

Current Documentation

The Agent SDK gives you the same tools, agent loop, and context management that power Claude Code. It’s available as a CLI for scripts and CI/CD, or as Python and TypeScript packages for full programmatic control.

What's Wrong or Missing?

This documentation does not warn the user that if they are using a subscription account they can be banned for using headless mode. Referring https://www.anthropic.com/legal/consumer-terms in particular:

You may not access or use, or help another person to access or use, our Services in the following ways:

...

7. Except when you are accessing our Services via an Anthropic API Key or where we otherwise explicitly permit it, to access the Services through automated or non-human means, whether through a bot, script, or otherwise.

Suggested Improvement

The headless mode documentation should warn about the potential conflict.

The headless mode itself should fail if the user has been flagged for such misuse before banning the account as a means of warning the user.

Impact

High - Prevents users from using a feature

Additional Context

This failure in documentation and warning causes people to be unable to use Claude for the foreseeable future because they learn about the issue when their account is banned.