CCE - Claude Config Environment

中文版文档

🧙 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