Integrations
Anthropic Claude
Configure the Anthropic Claude API for AI pipelines and the chat assistant. Required.
Anthropic Claude
Anthropic Claude is the AI engine powering all 17 pipelines and the global chat assistant in GridWork HQ. This is a required integration.
What It Does
- Pipeline Server — spawns Claude Code CLI processes for each pipeline run. Different pipelines use different model tiers (Haiku, Sonnet, Opus) based on their complexity.
- AI Chat — the floating action button (FAB) on every dashboard page sends messages to Claude via the Anthropic API.
- Cron Jobs — scheduled tasks that involve AI processing (friday-update, scope-audit, kb-librarian) use Claude.
Setup
- Sign up at console.anthropic.com
- Navigate to API Keys and create a new key
- Add it to both environment files:
# In gridwork-hq/.env.local
ANTHROPIC_API_KEY=sk-ant-your-key-here
# In pipeline-server/.env
ANTHROPIC_API_KEY=sk-ant-your-key-hereEnvironment Variables
| Variable | Where | Purpose |
|---|---|---|
ANTHROPIC_API_KEY | Both .env.local and pipeline-server/.env | API authentication |
Model Routing
Pipelines automatically select the appropriate Claude model tier based on their definition:
| Model | Used By | Typical Use |
|---|---|---|
| Haiku | kb-librarian, archive-outputs | Light maintenance tasks |
| Sonnet | prospect, audit (pass 1), build, outreach (pass 1), content (pass 1) | Implementation and drafting |
| Opus | plan, propose, audit (pass 2), outreach (pass 2), build (review gate) | Planning, review, and high-quality output |
Model selection is defined in each pipeline's YAML frontmatter. The spawner reads this automatically — you do not need to configure it.
Cost Expectations
- AI Chat: approximately $0.01-0.05 per exchange
- Pipeline runs: varies by model and complexity. A prospect run (Opus) costs more than a kb-librarian run (Haiku).
- Cron jobs: minimal cost for lightweight scheduled tasks
Claude Code CLI
The pipeline server spawns Claude Code CLI processes. Install it globally:
npm install -g @anthropic-ai/claude-codeConfigure permissions in ~/.claude/settings.json:
{
"permissions": {
"allow": [
"Bash(git *)",
"Bash(npm *)",
"Bash(node *)",
"Read",
"Write",
"Edit"
]
}
}Without This Integration
Without ANTHROPIC_API_KEY:
- All 17 pipelines will fail to execute
- The AI chat FAB will not function
- AI-powered cron jobs will fail
- The dashboard itself will still load and function for non-AI features