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, Codex, and OpenCode 2 or later.
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. To run one step on its own, use a subcommand.

vercel setup

vercel setup gateway

vercel setup plugin --agent codex

vercel setup skills

vercel setup --dry-run

To run only the Vercel plugin step, use the vercel setup plugin subcommand:

vercel setup plugin

To run only the AI Gateway step, use the vercel setup gateway subcommand:

vercel setup gateway

vercel setup gateway also accepts the --all, --key, --reconfigure, and --no-session-migration options of vercel ai-gateway setup. To use that command's other options, such as a spend limit for a new key, run vercel ai-gateway setup.

The Vercel CLI skill guides a coding agent through deployment, configuration, and troubleshooting with the CLI version you have installed. To write the skill to ~/.agents/skills/vercel-cli, use the vercel setup skills subcommand:

vercel setup skills

vercel setup without a subcommand doesn't write the skill. Run vercel setup skills again after you upgrade the CLI to update the skill.

If your agent reads skills from another directory, pass the directory for the skill with the --output option:

vercel setup skills --output .agents/skills/vercel-cli

This subcommand doesn't prompt, and it doesn't accept the --agent or --yes options.

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

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, codex, or opencode.
• AI Gateway: any agent in the supported coding agents list, such as cursor or opencode.

vercel setup --agent claude-code

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

vercel setup --dry-run

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

vercel setup --yes

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

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --token
• --version

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