Claude Code setup
Claude Code is a stable LazyAI target for Claude-native agents, skills, slash commands, output styles, hooks, permissions, and MCP.
Generated structure
.
├── AGENTS.md
├── .mcp.json
└── .claude/
├── agents/<agent>.md
├── skills/<skill>/SKILL.md
├── commands/<command>.md
├── output-styles/<style>.md
├── hooks/<hook>.sh
├── rules/typescript.md
└── settings.json
flowchart LR
AI[".ai/ canonical source"] --> A[".claude/agents"]
AI --> S[".claude/skills"]
AI --> C[".claude/commands"]
AI --> O[".claude/output-styles"]
AI --> H[".claude/hooks + settings.json"]
MCP[".ai/mcp.json"] --> M[".mcp.json or Claude settings"]
Claude Code concepts LazyAI uses
| Claude Code concept |
LazyAI source |
| Root instructions |
AGENTS.md; existing CLAUDE.md compatibility is preserved |
| Agents/subagents |
canonical agent markdown rewritten to Claude Code frontmatter |
| Skills |
Agent Skills-compatible SKILL.md directories |
| Slash commands |
Claude Code command markdown |
| Output styles |
files under .claude/output-styles/ |
| Hooks |
shell hooks wired through .claude/settings.json |
| MCP |
.ai/mcp.json compiled to .mcp.json or Claude settings |
LazyAI options
| Use case |
Command |
| Add Claude Code during init |
lazyai-cli init --scope project --tools claude-code --preset standard --no-interactive |
| Let Claude CLI register MCP when available |
lazyai-cli init --scope project --tools claude-code --drive-cli --no-interactive |
| Keep secrets out of committed MCP files |
lazyai-cli compile --tool claude-code --local-secrets |
| Compile from manifest token |
lazyai-cli compile --tool claude-code |
Example
lazyai-cli init \
--scope project \
--tools claude-code \
--preset full \
--enable-servers filesystem,ripgrep \
--local-secrets \
--no-interactive
lazyai-cli compile --tool claude-code --local-secrets
lazyai-cli validate agents
Readiness notes
- Support level: stable.
- Project, workspace, and global scopes are supported.
- Claude Code has no chat-mode surface; LazyAI emits reusable prompts as commands.
--local-secrets routes Claude MCP/settings writes to gitignored local settings where supported.