Quickstart

Prerequisites

• Node.js 18+
• Claude CLI installed and authenticated

which claude
claude --version

For containerized usage, set CLAUDE_CODE_OAUTH_TOKEN.

Run the Service

npx clauditorium

Default bind: http://127.0.0.1:5051

Verify Core Endpoints

curl -s http://127.0.0.1:5051/health
curl -s http://127.0.0.1:5051/models
curl -s -X POST http://127.0.0.1:5051/ask \
  -H "Content-Type: application/json" \
  -d '{"prompt":"What is 2+2?"}'

Expected ask shape:

{
  "success": true,
  "response": "..."
}

Next Steps

1. Learn multi-turn context: First Chat Flow
2. Add API key and retry logic: Auth and Rate Limits
3. Review deployment guardrails: Production Hardening