Skip to content

Troubleshooting

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

Each entry links to the page that has the cause and the fix. An entry starts with the error code when the API returns one. Otherwise, it starts with the first words of the error message, or with what you see when there is no message. A word in capitals, such as SESSION_ID, stands for a value in your message.

A session does not start

Billing, plans and limits

CDP, Playwright and Puppeteer

A session ends early

Bot detection and CAPTCHAs

Stealth Browser

Proxies and dedicated IPs

Logins, profiles and credentials

Quick actions

Commands

MCP server and CLI

Files and extensions

Live view and recordings

If nothing matches