Claudius - Widget de Chat IA Embarcável
PMDevSolutions/Claudius
Widget de chat Claude embarcável em qualquer site com uma linha de código
Ver no GitHubPlugin open-source que oferece um widget de chat IA baseado em Claude, pronto para ser embutido em qualquer website com uma única tag script. Combina React + TypeScript no frontend com Cloudflare Workers no backend para manter a chave da API segura. Suporta instalação como componente React ou embed direto via CDN.
Instalação
npx convez-ai PMDevSolutions/Claudius1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Adicionar suporte por chat IA em websites existentes
- Criar assistentes personalizados para aplicações React/Next.js
- Implementar atendimento ao cliente 24/7 com IA
- Embeds de chat temáticos em landing pages e documentação
Veredito

Claudius é uma solução prática e bem-documentada para integrar chat de IA em websites sem complexidade. A arquitetura com Cloudflare Workers resolve elegantemente o problema de manter chaves de API seguras, e o suporte tanto a embed simples quanto a componentes React oferece flexibilidade real para diferentes casos de uso.
README
A tradução para o português deste README ainda está na fila.
Claudius - Embeddable AI Chat Widget
An open-source, embeddable AI chat widget powered by Claude. Drop it into any website with a single script tag, or install it as a React component.
Full documentation: claudius-docs.pages.dev
Try it live at pmds.info or on the docs home page.
Quick start
Claudius is two pieces: a Cloudflare Worker (keeps your Anthropic API key server-side) and a widget embed.
Fastest: scaffold a project
npm create claudius@latest
Answer a few prompts (framework — vanilla, React, or Next.js — theme, accent color, worker API URL, and optionally a Cloudflare Worker) and you get a ready-to-run project. See the scaffolding guide.
Prefer to wire things up by hand? Continue below.
1. Deploy the worker
git clone https://github.com/PMDevSolutions/Claudius.git
cd Claudius/worker
pnpm install
npx wrangler login
npx wrangler kv namespace create RATE_LIMIT # paste the id into wrangler.toml
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler deploy
Then set ALLOWED_ORIGIN to your site's origin (Workers → Settings →
Variables). Comma-separate multiple origins.
2. Embed the widget
Add before </body>:
<script>
window.ClaudiusConfig = {
apiUrl: "https://claudius-chat-worker.<you>.workers.dev",
title: "Support",
subtitle: "Ask me anything",
theme: "auto",
};
</script>
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/gh/PMDevSolutions/Claudius@1/cdn/claudius.css"
/>
<script src="https://cdn.jsdelivr.net/gh/PMDevSolutions/Claudius@1/cdn/claudius.iife.js"></script>
The @1 CDN channel auto-updates within v1.x. That's it.
3. Or install as a React component
Building a React app? Install from npm instead of the script embed:
npm install claudius-chat-widget react react-dom
import { ChatWidget } from "claudius-chat-widget";
import "claudius-chat-widget/style.css";
<ChatWidget
apiUrl="https://claudius-chat-worker.<you>.workers.dev"
title="Support"
/>;
The package ships dual ESM/CJS builds with TypeScript types. See the documentation for theming, localization, and SSR notes.
Documentation
| Section | What's there |
|---|---|
| Getting started | Architecture, quick start, local development |
| Configuration | Every widget and worker option, triggers, localization, theming, multi-client configs |
| Deployment | Worker setup, CDN vs self-hosted embed, per-host guides (static, WordPress, Replit, React/Next.js) |
| API reference | REST endpoints, error codes, widget TypeScript API |
| Migration guides | Upgrading between versions |
| FAQ | CORS, rate limits, CSP, privacy |
Development
cd worker && pnpm install && pnpm dev # http://localhost:8787
cd widget && pnpm install && pnpm dev # http://localhost:5173
Tests: pnpm test in widget/ and worker/. Details in the
local development guide.
Tech stack
React 18 + TypeScript + Tailwind (widget) · Cloudflare Workers + Hono + Anthropic SDK (worker) · Claude Haiku 4.5 by default.
Contributing
Contributions are welcome — see CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md for how to report security issues responsibly.
License
Released under the MIT License.