Claude · Agents

Connect Claude to WhatsApp in 30 minutes, no code

A WhatsApp agent that answers your customers 24/7. The repo does the heavy lifting — you just follow the 7 steps from your terminal.

QQuentin Megevand
May 24, 2026 · 4 min read

A custom WhatsApp agent — no dev, no paid no-code

whatsapp-agentkit is an open source repo (by Hainrixz) that hands you all the plumbing for a turnkey WhatsApp AI agent: a FastAPI server, SQLite memory per phone number, Twilio or Meta Cloud API integration, and Claude (sonnet-4-6) as the brain. You drop in your API keys, describe your business, and the agent answers your customers for you.

Two paths depending on your setup: Claude Code, which scaffolds everything on your machine autonomously, or Cowork (the Claude app), which acts as a copilot to copy-paste the commands into your terminal. Same result, same repo — just two levels of autonomy.

Claude AI Lab

The Claude AI Lab is my Skool community where I share my Claude systems and the more advanced modules. Entry is free.

Join the Lab →
30 min
from clone to first message
0
lines of code to write
24/7
agent live once deployed

The agent handles conversational memory per customer (each number has its own history), loads your business files (PDF menu, FAQ, pricing) into its context, and you can give it a custom personality via a YAML. Final deployment on Railway to go to production, with a free Twilio sandbox to test without a credit card.

The thing to understand

The repo is built to be driven by Claude. Whether you use Claude Code or Cowork, Claude reads the project, asks you 10 questions about your business, and configures everything based on your answers. All you do is approve and copy-paste.

A

Path A · Claude Code — the autonomous setup

🔗 github.com/Hainrixz/whatsapp-agentkit
⚙️7 steps on autopilot from your terminal
1
Install Python 3.11+ and Node.js. Check with python3 --version and node --version. On Mac, brew install python node does the trick.
2
Install Claude Code globally. One command, followed by an Anthropic login on first launch: npm install -g @anthropic-ai/claude-code
3
Clone the repo and run start.sh. The script checks your environment and tells you if anything's missing: git clone https://github.com/Hainrixz/whatsapp-agentkit.git then cd whatsapp-agentkit && bash start.sh
4
Launch Claude Code in the folder. Type claude in the terminal. Claude reads the repo and asks you 10 questions about your business (name, industry, tone, hours, the agent's goal, files to ingest).
5
Give it your 3 API keys when it asks. Anthropic (sk-ant-...) from platform.anthropic.com. Twilio (Account SID + Auth Token + Phone, free sandbox) or Meta Cloud API (Access Token + Phone Number ID + Verify Token).
6
Local test in the terminal (before WhatsApp). Simulate a conversation without touching WhatsApp, to validate the personality and the replies: python tests/test_local.py
7
Deploy on Railway and wire up the webhook. Claude Code generates the commands to push to GitHub, walks you through linking the repo to railway.app, and dictates the webhook URL to paste into Twilio or Meta. You get your first real message.
B

Path B · Cowork — the copilot setup

💡No Claude Code? Make Cowork your terminal assistant

No Claude Code on your machine? The Cowork app (Claude.ai web or desktop) can dictate the exact same steps. You paste into your terminal, send it back the output, and it unblocks you. It's more manual, but it works.

⚙️6 steps in copilot mode
1
Open a new chat in Cowork. On claude.ai or the desktop app. Switch to the Sonnet 4.6 or Opus 4.7 model for execution quality.
2
Give it the repo context. Paste the URL github.com/Hainrixz/whatsapp-agentkit and write: "Walk me through cloning this repo step by step, installing the dependencies, configuring my business, and deploying the agent. I don't have Claude Code, so I'll copy-paste each command into my terminal."
3
Answer its business interview. Cowork will ask you the same 10 questions: business name, industry, the agent's persona, tone (pro / friendly / sales), hours, files to load into knowledge/. It prepares the content of config/business.yaml and config/prompts.yaml for you to paste.
4
Set up your .env under its guidance. It sends you the .env template with the variables (ANTHROPIC_API_KEY, TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE, or META_ACCESS_TOKEN, META_PHONE_NUMBER_ID, META_VERIFY_TOKEN). You fill in your real keys and save.
5
Run the local test and debug with it. Type python tests/test_local.py and paste the output into Cowork. If it crashes, it reads the error and gives you the fix. If the agent answers oddly, it tweaks the prompts.yaml YAML with you.
6
Deploy Railway + webhook with its checklist. Ask it: "Give me the exact checklist to push to GitHub, set up Railway, configure the env vars in production, and paste my webhook into Twilio." You follow it line by line.
My takeaway

Cowork adds 10 to 15 minutes vs Claude Code (copy-paste back and forth), but stays well under an hour. If you're doing this only once, Cowork is enough. If you're building several, install Claude Code.

Want to go further?

And day-to-day, I post one reel a day on Instagram: @quentin_iamarketing