tweakcc
is a lightweight, interactive CLI tool that lets you personalize your Claude Code interface.
Note
⭐ If you find tweakcc useful, please consider starring the repository to show your support! ⭐
With tweakcc, you can
- Create custom themes with a graphical HSL/RGB color picker
- Add custom thinking verbs that will show while Claude's working
- Create custom thinking spinner animations with different speeds and phases
- Change the "CLAUDE CODE" banner text to your own text with your own figlet fonts
- Supports Claude Code installed on Windows, macOS, and Linux, using npm, yarn, pnpm, bun, Homebrew, nvm, fnm, n, volta, nvs, and nodenv, or a custom location
- Style the user messages in the chat history beyond the default plain gray text
- Remove the ASCII border from the input box
tweakcc also
- Restores the token counter and elapsed time metric that were shown during generation before Claude Code 1.0.83
- Fixes a bug where the spinner animation is frozen if you have the
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
environment variable set (#46) - Allows you to change the context limit used with models from custom Anthropic-compatible APIs with a new environment variable,
CLAUDE_CODE_CONTEXT_LIMIT
Additionally, we're working on features that will allow you to
- Pick from over 70+ spinning/thinking animations from
cli-spinners
- Apply custom styling to the markdown elements in Claude's responses like code, bold, headers, etc
- Customize the shimmering effect on the thinking verb: disable it; change its speed, width, and colors
Run without installation:
$ npx tweakcc
# Or use pnpm:
$ pnpm dlx tweakcc
tweakcc
works by patching the Claude Code's minified cli.js
file. When you update your Claude Code installation, your customizations will be overwritten, but they're remembered in your ~/.tweakcc/config.js
configuration file, so they can be reapplied by just rerunning the tool.
tweakcc
is verified to work with Claude Code 1.0.100.
Run with installing it with npx tweakcc
. Or build and run it locally:
git clone https://github.com/Piebald-AI/tweakcc.git
cd tweakcc
pnpm i
pnpm build
node dist/index.js
- ccstatusline - Highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
- claude-powerline - Vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, and custom themes.
- CCometixLine - A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
- cc-statuslines - Transform your Claude Code experience with a beautiful, informative statusline. One command. Three questions. Custom statusline.
Run npx tweakcc
, go to Themes
, and modify existing themes or create a new one. Then go back to the main menu and choose Apply customizations to cli.js
.
Some of the text Claude Code outputs has no coloring information at all, and unfortunately, that text is rendered using your terminal's default text foreground color and can't be customized.
Yes! You can use the FORCE_COLOR
environment variable, a convention which many CLI tools including Claude Code respect. Set it to 0
to disable colors entirely in Claude Code.
Could you have have forgotten to actually set Claude Code's theme to your new theme? Run claude
and then use /theme
to switch to your new theme if so.
tweakcn
, though similarly named, is unrelated to tweakcc
or Claude Code. It's a tool for editing your shadcn/ui themes. Check it out!
Copyright © 2025 Piebald LLC.