RTK Setup for Claude Code and Codex

Small install helper for configuring RTK with:

• Claude Code
• Codex CLI

Related Repositories

• rtk-setup: installation helper for RTK
• cachyos-configs: desktop configs for the main workstation
• theme-pipeline: separate theming pipeline used by that workstation

Links:

• https://github.com/Judd-e/rtk-setup
• https://github.com/Judd-e/cachyos-configs
• https://github.com/Judd-e/theme-pipeline

The script is intended for Linux and macOS shells and works well with zsh.

What It Does

install-rtk-claude-codex.sh:

• installs rtk using Homebrew, Cargo, or RTK's upstream install script;
• adds ~/.local/bin to ~/.zshrc and ~/.bashrc when needed;
• runs rtk init -g for Claude Code;
• runs rtk init -g --codex for Codex when the codex CLI is already installed;
• verifies the installation with rtk --version, rtk gain, and rtk init --show.

Prerequisites

• Linux or macOS
• bash
• one of:
  • brew
  • cargo
  • curl
• Claude Code installed if you want Claude integration
• Codex CLI installed if you want Codex integration

Example Codex CLI install:

npm install -g @openai/codex
codex login

Usage

Make the script executable:

chmod +x ./install-rtk-claude-codex.sh

Run it:

./install-rtk-claude-codex.sh

Then restart Claude Code and Codex.

Options

./install-rtk-claude-codex.sh --brew
./install-rtk-claude-codex.sh --cargo
./install-rtk-claude-codex.sh --script
./install-rtk-claude-codex.sh --skip-codex
./install-rtk-claude-codex.sh --skip-claude
./install-rtk-claude-codex.sh --no-shell-rc

Verification

After restarting your tools, test with commands such as:

git status
rg TODO .

Useful checks:

rtk --version
rtk gain
rtk init --show

Uninstall

RTK integration:

rtk init -g --uninstall

If installed with Homebrew:

brew uninstall rtk

If installed with Cargo:

cargo uninstall rtk

Notes

• In Claude Code, RTK mainly helps for shell command output such as git, rg, cat, find, pytest, and similar tools.
• Claude Code built-in tools like Read, Grep, and Glob are not all automatically rewritten through the RTK shell hook.
• Codex integration uses RTK's Codex-specific initialization path from the upstream project.

Sources

• RTK README: https://github.com/rtk-ai/rtk
• RTK guide: https://www.rtk-ai.app/