ccode-kit

A lightweight Claude Code utility for managing third-party models. This tool simplifies the process of configuring and switching between different Claude API endpoints.

Version: 1.1.1

Features

• 🔄 Easy Model Management - Add, configure, and switch between different Claude models
• ✨ Active Model Detection - See which model is currently active with visual indicators
• 🎯 Input Validation - Ensures all configuration data is valid before saving
• 💡 Smart UI - Conditional options and status messages for better UX
• 🛡️ Safe Deletion - Confirmation prompt prevents accidental model removal

Installation

npm install -g ccode-kit

Usage

# Run Claude Code
ccode

# Run Claude with arguments
ccode <args>

# Show usage information (defaults to monthly)
ccode usage

# Show usage for specific periods
ccode usage daily
ccode usage weekly
ccode usage monthly
ccode usage yearly

# Model management
ccode model              # Interactively select and configure a Claude model
ccode model set          # Same as above (explicit 'set' subcommand)
ccode model add          # Add a new model configuration
ccode model delete       # Delete a model configuration

Model Management

Interactive Model Selection

The ccode model command provides an intuitive interface for managing your models:

• Active Model Highlighting - The currently active model is marked with "(Active)"
• Smart Reset Option - "Claude (Reset)" only appears when you have a custom model configured
• Default Mode Indicator - Shows "Claude in default mode" when no custom model is set
• Easy Addition - "+ Add new model" option always available at the bottom

Adding a New Model

When adding a model, you'll be prompted for:

1. Model Name - A friendly display name (e.g., "OpenRouter Claude")
2. API Key - Your API key for the service
3. Base URL - The API endpoint URL

All inputs are validated to ensure they're correct before saving.

Model Configuration

Models are stored in ~/.claude/models/ and selected models update your ~/.claude/settings.json with the appropriate environment variables:

• ANTHROPIC_AUTH_TOKEN - Your API key
• ANTHROPIC_BASE_URL - The API endpoint
• ANTHROPIC_MODEL - The model name

Examples

Adding a new model

Setting a model

Development

# Install dependencies
npm install

# Link for local testing
npm link

# Unlink the global package
npm unlink -g ccode-kit

# Run the CLI directly
node bin/cli.js

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC