Skip to main content

​
Quick Start

This guide will help you install A24Z, configure your first AI coding tool, and start monitoring your tool usage in under 5 minutes.

​
Prerequisites

Before you begin, make sure you have:
  • Node.js 18+ installed on your system
  • npm or pnpm package manager
  • An AI coding tool (Claude Code, Gemini CLI, or Codex)
  • An A24Z account (sign up at app.a24z.ai)

​
Step 1: Install the A24Z CLI

Install the A24Z CLI globally using npm: 
npm install -g a24z
Or using pnpm: 
pnpm add -g a24z
Verify the installation: 
a24z --version

​
Step 2: Authenticate

Log in to your A24Z account: 
a24z login
This will open a browser window where you can authenticate. The CLI will automatically store your credentials securely.
Your authentication token is stored in ~/.a24z/config.json and is used to securely communicate with the A24Z platform.

​
Step 3: Install Observability Hooks

Install the observability hooks for your AI coding tool. For Claude Code: 
a24z install claude-code
What this command does:
  • Configures direct CLI integration with Claude Code
  • Updates ~/.claude/settings.json automatically
  • Sets up comprehensive hook coverage for all tool events
  • Configures API endpoints and authentication
  • Enables real-time monitoring
That’s it! Your Claude Code tools are now being monitored.

​
Step 4: Verify Installation

Check that everything is working correctly: 
a24z status
You should see output similar to: 
✅ A24Z CLI is properly configured
✅ Authentication: Valid (org: YourOrganization)
✅ Claude Code: Hooks installed
✅ API Connection: Healthy

​
Step 5: Use Your AI Tools

Now, simply use Claude Code as you normally would. A24Z will automatically capture:
  • Tool executions and results
  • Success/failure rates
  • Execution times
  • Token usage and costs
  • Error logs and diagnostics

​
Step 6: View Your Dashboard

Open your dashboard to see real-time metrics:
  1. Go to app.a24z.ai
  2. Log in with your credentials
  3. Explore your tool usage, performance metrics, and insights

Sessions

View all your AI coding sessions and their performance

Tools

See which tools are used most and their success rates

Metrics

Track token usage, costs, and execution times

Team

Compare performance across your team (if applicable)

​
Troubleshooting

​
Hooks not firing?

  1. Run a24z status to check installation
  2. Verify ~/.claude/settings.json configuration
  3. Ensure a24z is in your PATH

​
Authentication issues?

  1. Run a24z login to re-authenticate
  2. Check your network connection
  3. Verify your account at app.a24z.ai

​
Not seeing data in the dashboard?

  1. Wait 30-60 seconds for data to propagate
  2. Refresh your dashboard
  3. Ensure you’ve used your AI tool after installing hooks
For more detailed troubleshooting, see our Troubleshooting Guide.

​
Next Steps

Team Onboarding

Onboard your entire team effectively

Playbooks

Role-specific guides for your use case

Configuration

Customize your A24Z setup

Metrics Guide

Understand key metrics and benchmarks

CLI Reference

Explore all CLI commands

Integrations

Learn about tool integrations

​
Advanced Usage

Once you’re comfortable with the basics, explore:
  • Multiple Organizations - Switch between organizations with a24z org switch
  • Team Collaboration - Invite team members and share insights
  • Custom Alerts - Set up notifications for performance issues
  • API Access - Use the A24Z API for custom integrations