> ## Documentation Index
> Fetch the complete documentation index at: https://docs.costa.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Costa CLI

> Authenticate to Costa and connect your AI coding tools (Claude Code, Codex, and more) to Costa’s API and models.

### What is `costa` CLI?

`costa` is the command-line tool for managing **Costa authentication** and **IDE / agent integrations**.

With `costa` CLI, you can:

* Connect Costa to your AI coding tools (Claude Code, Codex, and more)
* Check your Costa usage (sessions and points)

It is open source: [https://github.com/costa-app/costa-cli](https://github.com/costa-app/costa-cli)

***

### Installation

<Tabs>
  <Tab title="macOS">
    ### Homebrew (macOS)

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/costa-app/costa-cli/main/install.sh | sh
    ```
  </Tab>

  <Tab title="Linux">
    ### Linux (amd64)

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/costa-app/costa-cli/main/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows">
    Coming soon...
  </Tab>
</Tabs>

### How to use?

<Steps>
  <Step title="Authenticate">
    ```bash theme={null}
    costa login
    ```

    This opens your browser to complete OAuth authentication and securely stores credentials at:

    ```bash theme={null}
    ~/.config/costa/token.json
    ```
  </Step>

  <Step title="Configure Claude Code">
    ```bash theme={null}
    costa setup claude-code
    ```

    This configures Claude Code (CLI or VS Code extension) to use Costa’s API.

    ```bash theme={null}
    ~/.claude/settings.json
    ```
  </Step>

  <Step title="Verify setup">
    ```bash theme={null}
    costa setup status claude-code
    ```
  </Step>
</Steps>