docs: add BUN_BE_BUN=1 claude x / opencode x execution method

[ryoppippi]

Summary

Add documentation for running ccusage and @ccusage/opencode via native Claude Code and OpenCode CLIs using BUN_BE_BUN=1 environment variable.

What Changed

• installation.md: Add detailed "Running with claude x" section (collapsible) explaining how it works, requirements (native version only), and links to Bun/Claude Code docs
• getting-started.md: Add claude x option to Quick Start code group
• index.md: Mention claude x in Ultra-Small Bundle Size feature description
• statusline.md: Add claude x option to settings.json configuration examples with native version note
• opencode/index.md: Add opencode x option with native version requirement tip

Why

This leverages Bun's standalone executable feature (BUN_BE_BUN=1) which exposes full Bun CLI capabilities from native Claude Code/OpenCode binaries. Users with native installations can run ccusage without installing Bun separately.

References:

• Bun docs: Act as the Bun CLI
• Claude Code setup

Summary by CodeRabbit

• Documentation
  • Added code examples and guidance for the new claude x invocation method across multiple setup guides.
  • Expanded installation documentation with alternative invocation approaches (bunx, npx, pnpm options).
  • Provided detailed configuration examples for statusline setup, cost source options, and visual burn rate features.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

Documentation updates across multiple guide files introducing support for the claude x invocation method as an alternative to existing runners. Adds code examples, new guidance sections, and expanded setup instructions demonstrating the native Claude Code workflow integration.

Changes

Cohort / File(s)	Summary
Quick Start & Overview docs/guide/getting-started.md, docs/guide/index.md	Added bash code-block example with BUN_BE_BUN=1 claude x usage; updated Ultra-Small Bundle Size section with alternative invocation method
Installation Guide docs/guide/installation.md	Introduced new "Running with `claude x`" details section explaining requirements, benefits, and compatibility notes; added code examples showing native Claude Code workflow integration in multiple locations
OpenCode Setup docs/guide/opencode/index.md	Restructured installation instructions into code-group with multiple runners (bunx, npx, pnpm, opencode x); added tip block describing opencode x requirements
Statusline Configuration docs/guide/statusline.md	Expanded setup instructions with code-group containing multiple invocation examples (bun x, npx, claude x); added online mode example and new optional features sections for Visual Burn Rate and Cost Source Options

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• docs(codex): add critical bunx warning and shell alias recommendation #655: Adds alternative command invocation examples and runnable snippets (bunx/npx/claude x) across documentation files
• docs: update statusline documentation with cost source options #575: Modifies docs/guide/statusline.md to add/expand "Cost Source Options" configuration modes
• feat: add statusline command for Claude Code status bar integration #450: Updates docs/guide/statusline.md with additional runnable examples and expanded code-group blocks

Poem

🐰 A rabbit hops through docs so bright,
Adding claude x to take flight!
Bun and npm dance in a row,
Native workflows steal the show!
✨ Multiple runners, one vision true!

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@ccusage/amp

npm i https://pkg.pr.new/ryoppippi/ccusage/@ccusage/amp@814

ccusage

npm i https://pkg.pr.new/ryoppippi/ccusage@814

@ccusage/codex

npm i https://pkg.pr.new/ryoppippi/ccusage/@ccusage/codex@814

@ccusage/mcp

npm i https://pkg.pr.new/ryoppippi/ccusage/@ccusage/mcp@814

@ccusage/opencode

npm i https://pkg.pr.new/ryoppippi/ccusage/@ccusage/opencode@814

@ccusage/pi

npm i https://pkg.pr.new/ryoppippi/ccusage/@ccusage/pi@814

commit: 7fc2a15

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	ccusage-guide	7fc2a15	Jan 19 2026, 03:27 PM