中文版文档

🧙 A Claude environment variable switching tool written in Rust, allowing you to easily manage multiple Claude API service providers.

• 🔄 Easy Switching - Quickly switch between different Claude API service providers
• 📝 Configuration Management - Securely store and manage multiple service provider configurations
• 🎨 User-Friendly Interface - Colorful output and intuitive command-line interface
• ⚡ High Performance - Built with Rust, fast startup and efficient execution
• 🔒 Secure & Reliable - Local configuration storage to protect your API keys

# Install with curl (supports Linux, macOS Intel & Apple Silicon) curl -sSL https://raw.githubusercontent.com/zhaopengme/cce/master/install.sh | bash

# Visit https://github.com/zhaopengme/cce/releases # Download the appropriate binary for your platform: # - cce-linux-x86_64.tar.gz (Linux) # - cce-macos-x86_64.tar.gz (macOS Intel) # - cce-macos-aarch64.tar.gz (macOS Apple Silicon)  # - cce-windows-x86_64.exe.zip (Windows) # Extract and install tar -xzf cce-*.tar.gz chmod +x cce mv cce ~/.local/bin/ # Make sure ~/.local/bin is in your PATH

# Clone the project git clone https://github.com/zhaopengme/cce.git cd cce # Build the project cargo build --release # Install (optional) cargo install --path .

# Download and run the PowerShell installer Invoke-WebRequest -Uri "https://raw.githubusercontent.com/zhaopengme/cce/master/install.ps1" -OutFile "install.ps1" .\install.ps1

The key feature of CCE is the ability to make cce use and cce clear commands take effect immediately in your current terminal.

🚀 Automatic Setup (Recommended):

cce install

This command will automatically:

• 🔍 Detect your shell (bash or zsh)
• ✅ Append a CCE block to your shell profile
• ⚡ Load the most recent provider every time a new terminal starts
• 🪄 Wrap the cce command so cce use / cce clear update the current session instantly

After installation completes, open a fresh terminal to pick up the changes. To activate immediately, run source ~/.zshrc or source ~/.bashrc.

🔧 Manual Setup (other shells or custom setups)

# Add this block to your shell configuration file (~/.zshrc, ~/.bashrc, etc.) if command -v cce >/dev/null 2>&1; then if [[ -f "$HOME/.cce/config.toml" ]]; then current_provider=$(awk -F'"' '/^current_provider/ {print $2; exit}' "$HOME/.cce/config.toml") if [[ -n "$current_provider" ]]; then eval "$(CCE_SHELL_INTEGRATION=1 cce use "$current_provider")" fi fi fi # Optional: add the shortcut wrapper identical to the installer eval "$(cce shellenv)"

Note: The Windows PowerShell installer writes the integration block to $PROFILE so each session automatically loads your last-used provider.

cce list

cce add <name> <API_URL> <API_TOKEN> [--model <MODEL_NAME>] # Examples cce add anthropic https://api.anthropic.com sk-ant-api03-xxxx cce add custom https://custom-claude-api.com custom-token-123 # With model specification (v0.2.0+) cce add my-provider https://api.example.com/v1 sk-token-123 --model claude-3-5-sonnet-20250229 # or using short option cce add my-provider https://api.example.com/v1 sk-token-123 -m claude-3-5-sonnet-20250229

cce delete <name> # Examples cce delete anthropic

With shell integration (recommended):

cce use anthropic # ⚡ Switched to service provider 'anthropic' # ✅ Environment variables are now active in current terminal

Without shell integration:

eval "$(CCE_SHELL_INTEGRATION=1 cce use anthropic)"

cce clear

This will unset ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL, allowing you to use your Claude Pro/Max subscription with the official client.

cce check

Outputs the helper function the installer uses for bash/zsh. Run eval "$(cce shellenv)" if you need to install the wrapper manually or customize it.

Display all configured service providers with their status:

• Provider name
• API URL
• Masked token preview
• Current active status

Add a new service provider:

• name: Custom provider name
• api_url: Claude API endpoint URL
• token: API access token
• --model / -m: Optional model name (v0.2.0+)

If the provider already exists, it will be overwritten. When a model is specified, ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, and ANTHROPIC_DEFAULT_HAIKU_MODEL environment variables will be exported when using this provider.

Remove the specified service provider. No confirmation required.

Switch to the specified service provider. By default this command prints a short confirmation message.

For scripts or shell integration, set CCE_SHELL_INTEGRATION=1 to emit environment variable commands:

eval "$(CCE_SHELL_INTEGRATION=1 cce use <name>)"

Verify current environment variable status:

• Display current environment variables
• Compare CCE configuration with actual environment variables
• Provide suggestions when there are mismatches

Clear environment variables to switch back to using the official Claude client.

For scripts or shell integration, set CCE_SHELL_INTEGRATION=1 to emit unset commands:

eval "$(CCE_SHELL_INTEGRATION=1 cce clear)"

This command will:

• Unset ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, and ANTHROPIC_DEFAULT_HAIKU_MODEL environment variables
• Clear the current provider selection in configuration
• Allow you to use your Claude Pro/Max subscription with the official client

Automatically install shell integration for immediate environment variable effects:

Normal mode (cce install):

• 🔍 Detect your current shell (bash or zsh)
• ✅ Check if integration is already installed
• 📝 Add integration to appropriate config file
• 💡 Provide activation instructions

Force mode (cce install --force):

• 🔄 Force reinstall even if already present
• 📝 Add integration regardless of existing setup

This command currently supports:

• Bash: Appends to ~/.bashrc (Linux) or ~/.bash_profile (macOS)
• Zsh: Appends to ~/.zshrc
• PowerShell: install.ps1 writes to $PROFILE
• Other shells: see the “Manual Setup” example above for guidance

After installation, restart your terminal or run source ~/.zshrc (or equivalent) to activate.

Configuration file is stored at ~/.cce/config.toml:

current_provider = "anthropic" [providers.anthropic] name = "anthropic" api_url = "https://api.anthropic.com" token = "sk-ant-api03-your-token-here" [providers.custom] name = "custom" api_url = "https://custom-claude-api.com" token = "custom-token-123" [providers.my-provider] name = "my-provider" api_url = "https://api.example.com/v1" token = "sk-token-123" model = "claude-3-5-sonnet-20250229"

After using cce use command, the following environment variables are automatically set:

• ANTHROPIC_AUTH_TOKEN: API authentication token
• ANTHROPIC_BASE_URL: API base URL
• ANTHROPIC_MODEL: Model name (if specified with --model when adding provider)
• ANTHROPIC_DEFAULT_OPUS_MODEL: Default Opus model (if specified with --model when adding provider)
• ANTHROPIC_DEFAULT_SONNET_MODEL: Default Sonnet model (if specified with --model when adding provider)
• ANTHROPIC_DEFAULT_HAIKU_MODEL: Default Haiku model (if specified with --model when adding provider)

# Add common providers cce add prod https://api.anthropic.com sk-ant-prod-xxx cce add dev https://dev-api.example.com dev-token-xxx # Quick switch (with shell integration) cce use prod cce use dev

#!/bin/bash eval "$(CCE_SHELL_INTEGRATION=1 cce use anthropic)" # Environment variables are now set and ready to use curl -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" "$ANTHROPIC_BASE_URL/v1/messages"

cce check # Check current status echo $ANTHROPIC_AUTH_TOKEN # Verify token echo $ANTHROPIC_BASE_URL # Verify URL

cp ~/.cce/config.toml ~/.cce/config.toml.backup

All releases include automated CI/CD testing across multiple platforms to ensure reliability.

If the one-click install fails:

# Check if curl is available curl --version # Check if your platform is supported uname -s && uname -m # Try manual installation from releases page # https://github.com/zhaopengme/cce/releases

• Re-run cce install --force to regenerate the integration block in your profile.
• Verify the CCE block exists in your profile file:

  grep -n "CCE Shell Integration" ~/.zshrc

• If you need to refresh the current terminal manually, run:

  eval "$(CCE_SHELL_INTEGRATION=1 cce use <provider-name>)"

Run cce check to diagnose the issue and follow the suggestions.

If cce command is not found after installation:

# Add ~/.local/bin to your PATH echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # Verify installation which cce cce --version

If the config file is corrupted, you can delete and recreate it:

rm -rf ~/.cce

Issues and Pull Requests are welcome!

• Author: @zhaopengme
• Twitter: https://x.com/zhaopengme

MIT License