Build: what an AI agent should do when it meets a CAPTCHA
For agent and framework developers: when a CAPTCHA appears, whether to proceed at all, and the three legitimate paths: sign, ask the site, hand off.
Facts on this page checked 2026-11-01
A CAPTCHA is a site saying "I want a person here." An agent that meets one should first ask whether it is wanted on that page, before it asks how to get past. This section is for people who build AI agents, browser-automation frameworks and hosted browsers. It covers the legitimate paths, and the rules and test pages that apply.
Ask first: is the agent wanted here?
A CAPTCHA does not tell the agent why it appeared. It can mean any of these:
| What the CAPTCHA means | What it implies for the agent |
|---|---|
| The site does not want automated visitors on this page at all. | Stop. Solving it goes against the site's wishes, and often its terms. |
| The site cannot tell a wanted agent from an unwanted one. | Identify the agent, so the site can decide. |
| The site wants a human decision here (a sign-up, a payment, a post). | Hand the step to the agent's human. |
| The visitor's address or browser looks risky, whoever is behind it. | Hand off, or try again later from a normal setup. Do not disguise the agent. |
Industry has moved to the same view. Cloudflare's framing: "There are wanted bots and there are unwanted humans" (Cloudflare, 2026-04-21, checked 2026-11-01). hCaptcha's: "Legitimate agents should clearly identify themselves" (hCaptcha, 2026-02-23, checked 2026-11-01). Anthropic's crawler page says "we will not attempt to bypass CAPTCHAs for the sites we crawl" (Anthropic support page, 2026-04-07, checked 2026-11-01).
The three legitimate paths
| Path | What it means | Where it works today | Page |
|---|---|---|---|
| Sign | The agent signs its requests with a published key (Web Bot Auth), so sites and bot-defence vendors can verify which product sent them and apply a policy instead of a puzzle. | Verified by Cloudflare, Google, HUMAN, Akamai, Fingerprint and Arkose; used by ChatGPT agent, Google-Agent and Browserbase (checked 2026-11-01). | Sign your agent |
| Ask the site | Register the agent with the site or its bot-defence vendor, use the site's API, or follow its published rules for bots. | Cloudflare's verified-bot programme takes submissions through a form (Cloudflare docs, checked 2026-11-03). Many sites offer an API. | Sign your agent |
| Hand off | Pause, tell the human which site and why, let them complete the step, then continue. | Claude Code's Chrome integration pauses at a CAPTCHA by design; Stagehand pauses the agent while its hosted browser handles a CAPTCHA (sources on the page). | Hand-off patterns |
Signing says which software is acting. It does not say which person allowed which action. That gap is open, and the industry roadmap tracks who is working on it.
What is not on the list
- Solving the puzzle by default. Solving can be within the rules: on your own site, with the site owner's permission, or in research on your own pages. As a default for an agent on someone else's site, it runs into vendor terms and model-provider policies. Some terms forbid it outright: hCaptcha's do (policy map).
- Paying a solving service. These services are largely human workers paid per solve. Anti-Captcha states that "100% of captchas are solved by human workers" (anti-captcha.com, checked 2026-11-01). We do not list or recommend them.
- Disguising the agent. Stealth tooling tends to make agents more detectable, not less: "Stealth and anti-detection mechanisms often increase detectability" (Fayolle et al., 2026, checked 2026-11-01). It also removes the one thing that makes an agent trustworthy: that it is accountable.
Background for this section: How AI agents fare against CAPTCHAs and What still works.
Pages in Build: what an AI agent should do when it meets a CAPTCHA
- Sign your agent: Web Bot Auth and verified bots
What Web Bot Auth is, who verifies signed agents, who signs today (and who does not), the identity-is-not-permission gap, and the steps to sign. - Hand-off patterns: when an agent should stop and ask its human
How agent frameworks pause at a CAPTCHA and hand the step to a person, what good hand-off looks like, and what agents actually choose when they meet one. - Policy and legal map for agents that meet CAPTCHAs
Vendor terms, AI-provider policies, GitHub rules and US and EU law that apply when an AI agent meets a CAPTCHA, each dated and linked to its source. - Test pages for agent developers, and which ones still work
The public CAPTCHA demo pages and bot-detection test sites agent developers use as fixtures, their measured status, and a maintained alternative.