Skip to content
Docs

vercel setup

The vercel setup command prepares your machine for coding agents in two steps:

  1. Vercel plugin: Installs the Vercel plugin for Claude Code and Codex.
  2. AI Gateway: Connects your local coding agents to AI Gateway. This runs the same flow as vercel ai-gateway setup.

The command prompts you before each step and skips agents it doesn't find on your machine.

terminal
vercel setup

Using the vercel setup command to install the Vercel plugin and connect coding agents to AI Gateway.

terminal
vercel setup --gateway
Skip the plugin step and only run the AI Gateway step.
terminal
vercel setup --plugin --agent codex
Only install the Vercel plugin, and only for Codex.
terminal
vercel setup --dry-run
Show what setup would change without writing any files.

These are options that only apply to the vercel setup command.

The --plugin option runs only the Vercel plugin step.

terminal
vercel setup --plugin
Only install the Vercel plugin for Claude Code and Codex.

The --gateway option runs only the AI Gateway step.

terminal
vercel setup --gateway
Only connect coding agents to AI Gateway.

The --agent option, value NAME, limits setup to one coding agent. Repeat it to select more than one. The values each step accepts are different:

  • Vercel plugin: claude-code or codex.
  • AI Gateway: any agent in the supported coding agents list, such as cursor or opencode.
terminal
vercel setup --agent claude-code
Install the plugin and connect AI Gateway for Claude Code only.

The --dry-run option shows what would change without writing any files.

terminal
vercel setup --dry-run
Preview setup changes.

The --yes option, shorthand -y, skips the confirmation prompts.

terminal
vercel setup --yes
Run setup without prompts.

The following global options can be passed when using the vercel setup command:

For more information on global options and their usage, refer to the options section.

Last updated October 1, 2026

Was this helpful?

supported.