Skip to main content

​
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

​
Installation

​
Homebrew (macOS)

curl -fsSL https://raw.githubusercontent.com/costa-app/costa-cli/main/install.sh | sh

​
How to use?

1

Authenticate

costa login
This opens your browser to complete OAuth authentication and securely stores credentials at:
~/.config/costa/token.json
2

Configure Claude Code

costa setup claude-code
This configures Claude Code (CLI or VS Code extension) to use Costa’s API.
~/.claude/settings.json
3

Verify setup

costa setup status claude-code