Skip to main content

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.

Connect Claude Code to Costa. Turn on Trim. Build a Cosmic Router.
Using a different tool? Codex · opencode · something else

​
Before you start

You’ll need:
  • Claude Code, installed and signed in with a subscription.
  • A terminal you’re comfortable in.
Don’t have a Claude Code subscription? Get one from Anthropic →, use your own Anthropic API key →, or add another provider →.
1

Install Costa

Copy this into your terminal and run it:
curl -fsSL https://raw.githubusercontent.com/costa-app/costa-cli/main/install.sh | sh -
When the install finishes, Costa walks you through:
  1. Creating your Costa account.
  2. Picking a callsign — your public username on Costa.
  3. Landing on the Integrations menu.
Stay in the TUI. The next step happens there.
2

Enable Claude Code

You’re now on the Integrations tab. You’ll see something like this:Use the arrow keys to highlight claude-code, then press Enter. Costa writes a token into ~/.claude/settings.json and flips the row to Enabled ✓.Restart Claude Code so it picks up the new config.
3

Send your first prompt

Open Claude Code (i.e. with claude) and ask it to do something real — fix a bug, write a test, refactor a file. Then open your session dashboard and watch your messages stream in.You’ll see the prompts, the model that handled it, the tool calls, and the running token count. That’s Costa working underneath Claude Code. You can also view your live dashboard to see response times by provider and model.

Next: Turn on Trim

Strip unused tokens before they reach the model.