diff --git a/docs/claude-config.md b/docs/claude-config.md
index 1f03e02ee..da61ea573 100644
--- a/docs/claude-config.md
+++ b/docs/claude-config.md
@@ -2,6 +2,28 @@
 
 > **TL;DR:** Warelay lets you turn Claude into a proactive personal assistant that lives in your pocket via WhatsApp. It can check in on you, remember context across conversations, run commands on your Mac, and even wake you up with music. This doc shows you how.
 
+---
+
+## ⚠️ Warning: Here Be Dragons
+
+**This setup gives an AI full access to your computer.** Before you proceed, understand what you're signing up for:
+
+- 🔓 **`--dangerously-skip-permissions`** means Claude can run *any* shell command without asking
+- 💸 **Costs add up fast** - Opus 4.5 with extended thinking on every message isn't cheap
+- 🤖 **AI makes mistakes** - it might delete files, send emails, or do things you didn't intend
+- 🔥 **Heartbeats run autonomously** - your AI acts even when you're not watching
+- 📱 **WhatsApp is not encrypted E2E here** - messages pass through your Mac in plaintext
+
+**Start conservative:**
+1. Use `claude-sonnet-4-5` instead of Opus (faster, cheaper, still great)
+2. Skip `--dangerously-skip-permissions` until you trust the setup
+3. Set `heartbeatMinutes: 0` to disable proactive pings initially
+4. Use a test phone number in `allowFrom` first
+
+This is experimental software running experimental AI. The author uses it daily, but your mileage may vary. **You are responsible for what your AI does.**
+
+---
+
 ## Meet Clawd 👋
 
 Clawd is @steipete's personal AI assistant built on warelay. Here's what makes it special: