# Stripe CLI Reference

The Stripe CLI is a command-line interface tool that lets you interact with the Stripe API directly from your terminal. It helps you develop and test your Stripe integrations more efficiently.

## Flags

The Stripe CLI supports various flags that modify the behavior of commands. These flags can be global (applying to all commands) or specific to individual commands.

### Global Flags

Global flags are available for most Stripe CLI commands.

*   `--api-key <key>`: Specifies the Stripe API key to use.
*   `--api-version <version>`: Sets the Stripe API version.
*   `--config <path>`: Specifies the path to the Stripe CLI configuration file.
*   `--log-level <level>`: Sets the logging level (e.g., `debug`, `info`, `warn`, `error`).
*   `--no-color`: Disables colored output.
*   `--verbose`: Enables verbose output.
*   `--version`: Displays the Stripe CLI version.
*   `--help`: Displays help information for the CLI or a specific command.

### Command-Specific Flags

Many commands have their own specific flags to customize their functionality. For example, the `stripe listen` command has flags to specify the port and address to listen on.

You can view the available flags for any specific command by running the command with the `--help` flag. For example:

```bash
stripe listen --help
```

This will display detailed information about the `listen` command, including its specific flags and their descriptions.

## Examples

Here are a few examples of how to use flags with Stripe CLI commands:

*   **Using a specific API key:**

    ```bash
    stripe customers list --api-key sk_test_YOUR_SECRET_KEY
    ```

*   **Listening on a different port:**

    ```bash
    stripe listen --port 8080
    ```

*   **Viewing help for the `stripe samples create` command:**

    ```bash
    stripe samples create --help
    ```