code_docs
Quickstart
Getting Started

Quickstart

Get from zero to your first rewarded API call in under 5 minutes. This guide walks you through signing up, installing the CLI, creating your first project, and seeing your spend tracked in real-time.

šŸ’”During early access, you can explore the full product with the demo account: sarah@dev.io / password

1. Sign Up

Visit the dashboard and create your account. Navigate to codecard.ai/dashboard/login and sign in. You'll land on the overview dashboard showing your balance, spend, and projects.

2. Install the CLI

The CLI is the primary interface for Code_. Install it globally via npm:

Terminal
npm install -g github:rajparekh7/codecard-cli

Or clone and build from source:

From source
git clone https://github.com/rajparekh7/codecard-cli.git
cd codecard-cli && npm install && npm run build
npm link  # makes 'codecard' available globally

3. Authenticate

Log in via the CLI. You can use the browser OAuth flow or provide an API key directly:

Terminal
# Interactive login (opens browser)
codecard auth login

# Or with an API key
codecard auth login --api-key YOUR_KEY

# Verify you're authenticated
codecard auth whoami
# → Name: Sarah Chen
# → Email: sarah@dev.io

4. Create Your First Project

Every project gets its own virtual Visa card, isolated spend tracking, and P&L. Creating a project takes one command:

Terminal
codecard project create "my-ai-app" --budget 3000
Output
āœ“ Project "my-ai-app" created
āœ“ Card •••• 7281 assigned
āœ“ Budget limit: $3,000/mo
ℹThe virtual card is ready to use immediately. Copy the card number from the dashboard to add it to your OpenAI, Anthropic, or cloud provider billing.

5. Track Your Spend

Once you start using your card for API calls and infrastructure, Code_ tracks everything automatically:

Terminal
# View all spend across projects
codecard spend

# Filter by project
codecard spend --project my-ai-app

# Check project profit & loss
codecard pnl my-ai-app

# See rewards earned
codecard rewards

# Check your balance
codecard balance

6. Connect an AI Agent (Optional)

Code_ exposes an MCP server so AI agents can manage your finances. Start it with one command:

Terminal
codecard mcp

Or add it to Claude Code for automatic integration:

Terminal
claude mcp add codecard -- codecard mcp
šŸ’”Once connected, ask Claude to "check my Code_ spend" or "create a new project called recipe-ai" — it will use the MCP tools automatically.

Next Steps

Now that you're set up, dive deeper: