Getting Started

A developer-centric guide to installing, configuring, and deploying your first AI product with Forge.

Prerequisites

Before you begin, ensure you have the following installed:

Node.js 22+ (required for the latest Claude Code features)
Claude Code CLI utility installed globally
An active Anthropic API key with sufficient credits

Installation

Install the Forge plugin via the Claude Code plugin manager.

bash

claude plugin add clawlabz/forge

Verify Installation

Check that Forge is installed and ready.

bash

claude\n> /forge:status

You should see the Forge version and a list of available skills.

Quick Start

Build your first product in one command.

bash

# Create a new directory for your project
mkdir my-product && cd my-product

# Launch Claude Code and run the build
claude
> /forge:build "Build an AI-powered markdown editor with live preview"

Forge will guide you through the 8-stage pipeline automatically. The entire process typically takes 10-30 minutes depending on project complexity.

Configuration

Customize the pipeline with a forge.config.yaml file in your project root.

yaml

# forge.config.yaml
project_name: "my-product"
stack: "nextjs-supabase"

pipeline:
  skip: []           # stages to skip (e.g., ["P1", "P6"])
  parallel: false    # run independent stages in parallel

deployment:
  provider: "vercel"
  domain: "my-product.example.com"
  env_file: ".env.production"

Supported Stacks

Stack	Status
Next.js + Vercel + Supabase	Stable
Next.js + Vercel + Prisma	Stable
React + Vite + Firebase	Beta
Astro + Cloudflare Pages	Beta
SvelteKit + Vercel	Planned
Nuxt + Netlify	Planned

Troubleshooting

Plugin not found after installation+

Make sure you have Claude Code v1.0+ installed. Run claude --version to check. If the issue persists, try reinstalling with claude plugin remove clawlabz/forge && claude plugin add clawlabz/forge.

Build fails at P5 (Code Generation)+

This usually means your Anthropic API key has insufficient credits. Check your balance at console.anthropic.com. Code generation is the most token-intensive stage.

Deployment fails at P7+

Ensure your Vercel token and Supabase credentials are configured in your environment. For the free tier, you must set these up manually. See the Configuration section above.