A CLI helper tool for Claude Code that provides profile management, multi-model routing, real-time status bar, and CCG Skills integration.
- Profile Management - Manage multiple API configurations and switch between them easily
- Real-time Status Bar - Display model info, token usage, and cost tracking in the terminal
- Multi-model Routing - Route requests to different LLM backends (Anthropic, OpenAI, Claude Code)
- CCG Skills Integration - Install and manage CCG Skills for multi-model collaboration
- i18n Support - English and Chinese interface
- Virtual Company - Multi-agent collaboration system (experimental)
- OpenAI Proxy - Adapter proxy for OpenAI-compatible endpoints
- YOLO Mode - Docker-based sandboxed execution environment
- Node.js >= 14.0.0
- npm >= 6.0.0
- Claude Code CLI installed
# Clone or download the project
cd cc-helper
# Install dependencies
npm install
# Global install (recommended)
npm install -g .
# Or use npm link for development
npm linkRun the setup wizard for first-time configuration:
node setup.jsOr on Windows:
setup.batcchelper --version
cchelper --helpcchelper
# or
ccThis opens the main menu where you can:
- Start Claude Code with active profile
- Manage profiles
- Install CCG Skills
- View connection status
- Change language settings
- Access Virtual Company features
# Manage profiles
cchelper profile
# View status
cchelper status
# Start Claude Code
cchelper start
# Start with a specific role
cchelper start --role developer
# Install CCG Skills
cchelper ccg install
# Start in YOLO mode (Docker sandbox)
cchelper yolocc-helper/
├── index.js # Main entry, CLI and interactive menu
├── package.json # Project configuration
│
├── lib/ # Core modules
│ ├── profile.js # Profile CRUD, sync to Claude settings
│ ├── ccg.js # CCG Skills installation
│ ├── runner.js # Claude Code launcher with role injection
│ ├── statusbar.js # Real-time status bar (token/cost tracking)
│ ├── statusline.js # Claude Code statusLine integration
│ ├── i18n.js # Internationalization (zh-CN, en)
│ ├── theme.js # Terminal colors and symbols
│ ├── model-router.js # Multi-model LLM routing
│ ├── adapter-proxy.js # Anthropic to OpenAI format proxy
│ ├── yolo.js # Docker sandbox mode
│ ├── virtual-company.js # Multi-agent collaboration UI
│ ├── virtual-company-runtime.js # Agent process management
│ ├── virtual-company-storage.js # Workspace persistence
│ ├── company-planner.js # AI company structure planning
│ └── role-prompt-writer.js # Role prompt generation
│
├── setup.js # First-run setup wizard
├── setup.bat / setup.ps1 # Windows setup launchers
├── uninstall.js # Uninstall script
├── cchelper.cmd / cchelper.ps1 # Windows launchers
├── test.bat / test.ps1 # Test scripts
└── Dockerfile.yolo # Docker image for YOLO mode
- Windows:
%APPDATA%\cc-helper-nodejs\Config\config.json - macOS/Linux:
~/.config/cc-helper-nodejs/config.json
{
"profiles": [
{
"name": "Production",
"url": "https://api.anthropic.com",
"key": "sk-ant-xxxxx"
}
],
"activeProfile": "Production"
}- Windows:
%USERPROFILE%\.claude\commands\ccg\ - macOS/Linux:
~/.claude/commands/ccg/
commander- CLI frameworkinquirer- Interactive promptschalk- Terminal colorsboxen- Box drawingconf- Configuration managementaxios- HTTP clientexeca- Process execution
# Reinstall globally
npm install -g .
# Or check npm global path
npm config get prefixEnsure Claude Code CLI is installed:
claude --versionVisit https://github.com/anthropics/claude-code for installation.
- Check network connection
- Verify API URL is correct
- Check firewall settings
- Use
cchelper statusto diagnose
# Install dependencies
npm install
# Link for development
npm link
# Run tests
.\test.ps1 # PowerShell
test.bat # CMDISC
- Claude Code - Anthropic's official CLI
- CCG Skills - Multi-model collaboration skills
- Anthropic API - API documentation