# Vercel CLI Global Options

Global options are commonly available to use with multiple Vercel CLI commands.

## Current Working Directory

The `--cwd` option can be used to provide a working directory (that can be different from the current directory) when running Vercel CLI commands.

This option can be a relative or absolute path.

```bash filename="terminal"
vercel --cwd ~/path-to/project
```

## Debug

The `--debug` option, shorthand `-d`, can be used to provide a more verbose output when running Vercel CLI commands.

```bash filename="terminal"
vercel --debug
```

## Global config

The `--global-config` option, shorthand `-Q`, can be used set the path to the [global configuration directory](/docs/project-configuration/global-configuration).

```bash filename="terminal"
vercel --global-config /path-to/global-config-directory
```

## Help

The `--help` option, shorthand `-h`, can be used to display more information about [Vercel CLI](/cli) commands.

```bash filename="terminal"
vercel --help
```

```bash filename="terminal"
vercel alias --help
```

## Local config

The `--local-config` option, shorthand `-A`, can be used to set the path to a local `vercel.json` file.

```bash filename="terminal"
vercel --local-config /path-to/vercel.json
```

## Scope

The `--scope` option, shorthand `-S`, can be used to execute Vercel CLI commands from a scope that’s not currently active.

```bash filename="terminal"
vercel --scope my-team-slug
```

## Token

The `--token` option, shorthand `-t`, can be used to execute Vercel CLI commands with an [authorization token](/account/tokens).

```bash filename="terminal"
vercel --token iZJb2oftmY4ab12HBzyBXMkp
```

## No Color

The `--no-color` option, or `NO_COLOR=1` environment variable, can be used to execute Vercel CLI commands with no color or emoji output. This respects the [NO\_COLOR standard](https://no-color.org).

```bash filename="terminal"
vercel login --no-color
```

## Team

The `--team` option, shorthand `-T`, can be used to specify a team slug or ID for the command. This is useful when you need to run a command against a specific team without switching scope.

```bash filename="terminal"
vercel list --team my-team-slug
```

```bash filename="terminal"
vercel deploy -T team_abc123def
```

## Version

The `--version` option, shorthand `-v`, outputs the current version number of Vercel CLI.

```bash filename="terminal"
vercel --version
```


--------------------------------------------------------------------------------
title: "vercel guidance"
description: "Enable or disable guidance messages in the Vercel CLI using the vercel guidance command."
last_updated: "2026-02-03T02:58:38.079Z"
source: "https://vercel.com/docs/cli/guidance"
--------------------------------------------------------------------------------