better-clawd
Health Warn
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 7 GitHub stars
Code Warn
- network request — Outbound network request in package.json
- process.env — Environment variable access in scripts/perf.ts
- process.env — Environment variable access in src/QueryEngine.ts
- network request — Outbound network request in src/assistant/sessionHistory.ts
- process.env — Environment variable access in src/bootstrap/state.ts
- network request — Outbound network request in src/bridge/bridgeApi.ts
- process.env — Environment variable access in src/bridge/bridgeConfig.ts
Permissions Pass
- Permissions — No dangerous permissions requested
This tool is a fork of the Claude Code CLI designed to offer better performance and flexibility. It allows developers to use alternative AI providers like OpenAI and OpenRouter while removing default telemetry and vendor lock-in.
Security Assessment
The overall risk is Medium. The tool legitimately makes outbound network requests to connect to supported AI provider APIs (OpenAI, OpenRouter, Anthropic) and accesses environment variables to retrieve API keys for authentication. These actions are expected given its purpose, and no hardcoded secrets were detected. However, the tool does not declare an official software license, which is a significant legal and security grey area. Unlicensed code means the creator retains all rights, technically making it a copyright violation to use, modify, or distribute the code without explicit permission.
Quality Assessment
The project is very new and currently has low community visibility with only 7 GitHub stars, meaning it has not undergone broad peer review. That said, it is highly active, with the most recent code push occurring today. The documentation is clear, straightforward, and details exactly what the fork changes from the original upstream software.
Verdict
Use with caution — while the code functions as intended without dangerous permissions, the lack of an open-source license and minimal community testing makes it a potential legal and stability risk for production environments.
Claude Code, but better: better performance, OpenAI/OpenRouter support, no telemetry, no lock-in.
Better-Clawd
Claude Code, but better.
Better-Clawd exists because the original had a genuinely great core idea and too many self-inflicted problems around it. This fork keeps what worked, fixes what did not, and gives people real choice over how they log in, which provider they use, and how much of the product they actually want phoning home.
No telemetry. No vendor lock-in. Faster startup, lower idle overhead, and better long-session performance than the original Claude Code. Less corporate baggage.
Install
npm install -g better-clawd
Or run it without a global install:
npx better-clawd
Why This Fork Exists
Claude Code had the bones of a best-in-class coding CLI, but too much of the experience was tied to one company, one backend, one set of assumptions, and one way of doing things.
Better-Clawd is the response to that.
- It keeps the good parts of the original UX
- It removes telemetry and unnecessary phone-home behavior
- It supports multiple providers without turning setup into a science project
- It improves performance over the original Claude Code, with better startup behavior, less idle background churn, and smoother long sessions
- It is easier to inspect, modify, and run on your own terms
Performance
Better-Clawd is intentionally tuned to be leaner than upstream Claude Code:
- Lower startup and initialization cost
- Less background polling and idle CPU churn
- Better memory and render behavior during long transcript-heavy sessions
- Focused performance workflow and regression checks in
PERFORMANCE.md
What Better-Clawd Changes
- Full Better-Clawd rebrand across the CLI, UI, config paths, installers, and app identity
- OpenAI support with API keys and Codex-based login import/refresh flow
- OpenRouter support with proper provider wiring
- Anthropic support kept for people who still want it
- Telemetry stripped out
- Upstream service dependencies reduced or removed where they made the project worse
- Local-first behavior wherever possible
Provider Support
Better-Clawd currently supports:
- Anthropic login and API key flows
- OpenAI API keys
- OpenAI Codex login import and refresh flow
- OpenRouter API keys
Default endpoints:
- OpenAI base URL:
https://api.openai.com/v1 - OpenAI websocket mode endpoint:
wss://api.openai.com/v1/responses - OpenRouter base URL:
https://openrouter.ai/api/v1 - OpenRouter Responses API:
https://openrouter.ai/api/v1/responses
Quick Start
- Run
better-clawd - Run
/login - Pick your provider and complete the flow
- Run
/statusto confirm the active provider and auth method
The intended setup path is inside the CLI itself. Environment variables still work, but they are mostly useful for CI, headless usage, forced provider selection, or custom/proxied endpoints.
Environment Examples
OpenAI:
BETTER_CLAWD_API_PROVIDER=openai
OPENAI_API_KEY=your_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
OpenRouter:
BETTER_CLAWD_API_PROVIDER=openrouter
OPENROUTER_API_KEY=your_key_here
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
What You Get
- Better provider freedom
- Better performance than the original Claude Code across startup, idle usage, and long sessions
- OpenAI and OpenRouter support without weird bolt-on hacks
- Less phone-home behavior
- A CLI that feels more practical, more open, and more yours
Project Direction
The direction is straightforward:
- Keep the parts of Claude Code that were actually good
- Remove the parts that made it annoying, restrictive, or bloated
- Support multiple providers without making daily usage worse
- Keep the project useful instead of over-managed
If you liked the original idea but got tired of the lock-in, this is the fork.
Disclaimer
Better-Clawd is an independent, unofficial community project and is not affiliated with, endorsed by, or sponsored by Anthropic, PBC.
Claude, Claude Code, and related names, marks, and branding are the property of Anthropic, PBC or their respective owners. They are referenced here only to describe compatibility, origin, and the purpose of this fork.
The intent here is interoperability, commentary, and fair reference, not impersonation.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found