AI agent instructions
AI agent instructions
Prerequisites
- An
ANTHROPIC_API_KEYwith Managed Agents access - A Notte API key (get one here)
- Node 22 or later
1. Install the SDK
2. Create the environment and vault
The environment is the sandbox image. The vault holds your Notte key and substitutes it into outbound requests, so the key never appears in the model’s context.3. Run an agent
Two networking planes
These are easy to confuse and they do different jobs. Environment networking is a firewall on the container. It decides which hosts the sandbox can reach at all, at build time and at run time. The Go module proxy belongs here:allow_package_managers covers npm and PyPI but not proxy.golang.org, so without those hosts the image builds with Go present and no notte binary.
Credential networking decides where a secret may be substituted. Scope it to the hosts that actually consume the key, so a prompt injection cannot exfiltrate it to an attacker’s domain.
Next steps
Claude Code
Use Notte from Claude Code instead
MCP Server
Connect over MCP rather than the CLI
Browser Agents
Hand a whole task to a Notte agent
Vaults
Notte’s own credential store