English | 中文 | Français | Русский | हिन्दी | العربية | Português

ClawCodex

A production-oriented Python rebuild of Claude Code — real architecture, reliable CLI agent

Ported from the TypeScript reference implementation and extended with a Python-native runtime

🔥 Active Development • New Features Weekly 🔥

🏆 Terminal-Bench 2.1

80.9% on Claude Opus 5 — a top-tier open-source result

72 of 89 tasks solved (pass@1) on the verified 89-task suite. On the public leaderboard that slots around 3rd — behind Claude Code / Fable 5 (83.8%) and Codex / GPT-5.5 (83.1%), ahead of Claude Code on Opus 4.8 (78.9%).

ClawCodex — the open-source Python rebuild of Claude Code — run headless on claude-opus-5 at effort=xhigh. A single run (k=1) against the board's k=5 averages; benchmarked on main at #756. Fully reproducible from the open-source Harbor adapter. Read the full breakdown ↓

🌿✂️ /eco Token Compression

Same session, 80% fewer Bash-output tokens

Measured, not estimated: 27 real command outputs replayed through the production pipeline — 92,989 → 17,767 tokens (-80%). Failure summaries keep the error lines that matter; anything lossy is teed to disk, one tail away.

One toggle, deterministic filters — failure-focused test summaries, git/pip/npm ceremony stripping, log dedup, recoverable head-caps — guarded to be never worse than the raw rendering. Stacks with the DeepSeek prefix cache: the cache makes your stable prefix nearly free, /eco shrinks the fresh suffix every turn actually pays for. See the measured benchmark ↓

🐋🔥 DeepSeek Prefix Cache

Run long agentic coding sessions for pennies

Cache-hit input bills at $0.003 / 1M tokens — about 3,300× cheaper than Claude Fable 5 ($10 / 1M).

ClawCodex keeps your request prefix byte-stable, so DeepSeek's prompt cache covers your whole system + tools + history span across turns. The longer you code, the more you save.

deepseek-flash (DeepSeek-V4.1-Flash) off-peak, checked 2026-09-10. DeepSeek doubles every rate during peak hours (01:00–04:00 and 06:00–10:00 UTC, Mon–Fri) — still ~1,600× cheaper there. /cost follows the schedule.

🐜 --nano Mode

The pi-style minimal harness, built in

Full Terminal-Bench 2.1, same model, head-to-head with the pi harness (its own TB setup, vision+websearch matched): nano 64/89 (71.9%) at $1.31 vs pi 63/89 (70.8%) at $2.01 — equal-or-better score, 35% cheaper, k=1.

Six tools, a ~2K-token fixed payload (vs ~16K default), zero per-turn injections, /eco on. clawcodex --nano -p "<task>" ports the pi harness's edit ladder (multi-edit + fuzzy match), truncation guard, and compaction file-ledger — while non-nano behavior stays byte-identical. docs/nano.md

⚡ Quick Install

One line — installs uv, Python 3.10+, and puts clawcodex on your PATH.

macOS / Linux / WSL / Git Bash:

curl -fsSL https://clawcodex.app/install.sh | bash

Windows (native PowerShell — no WSL needed):

irm https://clawcodex.app/install.ps1 | iex

Then configure a provider and start coding:

clawcodex login   # interactive provider + API key setup → ~/.clawcodex/config.json
clawcodex         # start it in any project — Full Access by default, /permissions to change
clawcodex web --build  # first run: build and start the Web UI at http://127.0.0.1:8081

Both installers ship the same clawcodex lifecycle helpers — doctor (diagnose your environment), verify (health-check the install), update, and uninstall — and are re-run-safe. To pass flags through the pipe: curl -fsSL https://clawcodex.app/install.sh | bash -s -- --dry-run on POSIX, or & ([scriptblock]::Create((irm https://clawcodex.app/install.ps1))) -DryRun on Windows. Windows prerequisite: Git for Windows — its Git Bash is what the shell tool runs commands with.

git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex
python3 -m venv .venv && source .venv/bin/activate   # Python 3.10+
pip install -r requirements.txt

python -m src.cli login   # writes config to ~/.clawcodex/config.json

python -m src.cli   # start it (Full Access by default; /permissions to change)

The configuration file is saved at ~/.clawcodex/config.json. Minimal example:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-flash"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Note: TAVILY_API_KEY is required for the WebSearch tool — get a key at tavily.com.

The session, settings, and env blocks are optional — sensible defaults apply when they're omitted. See Configure for the full structure.

📰 News

• 2026-08-15 (v1.6.0): ClawCodex Web — the whole agent in a browser tab (ui-web/, clawcodex web) — one command serves the full agent at a stable, typeable address: http://127.0.0.1:8081. It is deliberately not a second server: the browser drives the same in-process agent, JSON-RPC gateway, and durable session store as the TUI and the Desktop app — start a session in one surface, resume it in another. The UI is a three-column shell (session tree | conversation | details) with streaming replies and collapsible reasoning, live tool cards (ANSI-colored terminal transcripts, unified diffs, line-numbered file reads), permission approvals as a composer takeover with once/session/always grants, a prompt queue for follow-ups typed mid-turn, slash-command completion, a context meter with per-category breakdown, a To-dos panel folded live from the transcript, and light/dark/system themes. Two views per session: Chat is the conversation; Trajectory is the same run as a metered ledger — every model request and tool call on a three-lane timeline with per-step tokens and timing (TTFT, throughput, cache-hit rate), model time and tool time reported separately. A Settings page covers what used to need slash commands or hand-editing config.json: provider API keys (add / replace / disconnect, stored where clawcodex login stores them), the default provider new sessions start on, the approvals default (with a Full-access confirmation that means it), response language, output style, and the end-of-turn recap toggle. GET / inlines the session token so the bare URL works after launch — and because of that, clawcodex web binds loopback only unless you explicitly pass --allow-remote.
• 2026-08-09 (later that day): ClawCodex Desktop runs and packages on Windows — npm run dist:win:nsis in ui-desktop/ now produces a working unsigned NSIS installer (ClawCodex-<version>-win-x64.exe, crab icon and version info stamped via rcedit, node-pty conpty binaries staged), and clawcodex desktop launches the dev app natively. The packaged app boots the same %USERPROFILE%\.clawcodex\clawcodex backend that install.ps1 creates — one shared install, config, and session store across CLI, TUI, and Desktop. Verified live on Windows 11: silent NSIS install → app boot → backend spawned from the shared venv → healthy loopback gateway → real DeepSeek turns on the shared keys. Also fixed along the way: the in-app updater's relaunch resolver pointed at the upstream apps/desktop/ layout (never matching ui-desktop/), its bash relaunch handoff now honestly reports manual-restart on Windows, and a hashbang broke vitest collection of the packaging tests.
• 2026-08-09: Native Windows support for the CLI — ClawCodex now runs first-class on Windows 10/11 (PowerShell / cmd / Windows Terminal, no WSL required), installed with one line: irm https://clawcodex.app/install.ps1 | iex. The new install.ps1 mirrors install.sh end to end — uv install, Python provisioning, lock-pinned deps, PATH registration, TUI build, plus the same doctor / verify / update / uninstall lifecycle. Under the hood the port is structural, not cosmetic: a shell platform layer resolves Git Bash for the Bash tool (explicitly refusing the WSL System32\bash.exe shim), so shell commands keep their POSIX semantics everywhere; process-tree kills go through taskkill /T; the mailbox/transcript/lockfile gain real msvcrt locking (the Windows CRT's O_APPEND emulation can silently lose concurrent writes); the permission layer folds NTFS case-insensitivity and refuses whole-drive grants and drive-relative escapes (deny-side only); and @-mentions, CLAWCODEX.md @includes, an