Claude Code Setup

Claude Code is Anthropic's official AI coding agent. It uses the Claude API and supports the full Fabriq feature set.

Prerequisites

• Anthropic API key — get one from console.anthropic.com
• Node.js 18 or later
• npm or pnpm package manager

Install

npm install -g @anthropic-ai/claude-code
# or
pnpm add -g @anthropic-ai/claude-code

This installs the claude CLI globally.

For alternative installation methods, see the official Claude Code documentation.

API key setup

1. Go to console.anthropic.com and create an API key
2. Set the key in your environment:

export ANTHROPIC_API_KEY=sk-ant-...your-key-here

Or configure it in Fabriq directly: Settings → Agent → Claude Code → API Key

Verify

claude --version
# → claude-code/0.2.0

If the command is not found, check that the global npm/bin directory is in your PATH.

Configure in Fabriq

1. Launch Fabriq
2. Go to Settings → Agent
3. From the Agent Backend dropdown, select Claude Code
4. If you haven't set the API key in your environment, enter it in the API Key field
5. Fabriq will verify the connection and show:

Agent: Claude Code v0.2.0 ● Connected

What happens when Fabriq connects

Fabriq starts Claude Code as a subprocess and communicates via ACP:

Fabriq Desktop ◄── ACP stdio JSON-RPC ──► Claude Code subprocess

The subprocess lifecycle is managed by Fabriq — no need to keep a terminal open.

Troubleshooting

Problem	Check
claude: command not found	Claude Code isn't in your PATH. Reinstall or add the npm global bin directory to your shell config
"Authentication failed"	Your Anthropic API key is missing or invalid. Check the key in Settings → Agent or your .env
"Rate limited"	You've exceeded your API rate limit. Wait and retry, or check your Anthropic plan
"Connection failed" after selecting	Try running claude directly in a terminal. If it fails, Fabriq won't be able to start it
Agent connects but is slow	Claude API response time varies by model. Check activity log for progress
"Version mismatch"	Update both Fabriq and Claude Code to the latest versions

Next steps

• Injecting Context — give Claude Code the project knowledge it needs
• Working with the Agent — guide Claude Code during a feature
• Creating a Feature — start your first feature with Claude Code