Build agents with
Claude Code
The fastest way to create AI agents. Claude Code understands your codebase and executes agents directly from markdown definitions.
5 min setup
No API keys needed
Works locally
Setup Steps
01
Install Claude Code
Get Claude Code CLI from Anthropic
npm install -g @anthropic-ai/claude-code 02
Install Squads CLI
Our CLI for managing agent squads
npm install -g squads-cli 03
Initialize your project
Create the agent structure
squads init 04
Run your first agent
Execute with Claude Code
claude "Run the research-agent from .agents/squads" Agent Definition
Agents are simple markdown files. Here's what gets created:
.agents/squads/research-agent.md
# Research Agent
## Purpose
Execute market research and competitor analysis.
## Model
claude-sonnet-4
## Tools
- WebSearch
- Read
- Write
## Instructions
1. Search for relevant market data
2. Analyze competitor positioning
3. Generate insights report
4. Save to .agents/outputs/
## Output
Markdown report with findings and recommendations.What happens when you run it
Claude Code reads the agent
Parses markdown, extracts model, tools, and instructions
Executes with context
Uses your codebase context and specified tools
Outputs results
Saves to .agents/outputs/ with full trace
Ready to build?
Start with the command below
npm install -g squads-cli && squads init