cc-copilot-bridge v1.7.0

Installation

Homebrew (macOS/Linux)

brew tap FlorianBruniaux/tap
brew install cc-copilot-bridge
eval "$(claude-switch --shell-config)"

Debian/Ubuntu (.deb)

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v1.7.0/claude-switch_1.7.0.deb
sudo dpkg -i claude-switch_1.7.0.deb
eval "$(claude-switch --shell-config)"

RHEL/Fedora (.rpm)

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v1.7.0/claude-switch-1.7.0-1.*.rpm
sudo rpm -i claude-switch-1.7.0-1.*.rpm
eval "$(claude-switch --shell-config)"

Manual Installation

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/archive/refs/tags/v1.7.0.tar.gz
tar xzf v1.7.0.tar.gz
cd cc-copilot-bridge-*
sudo install -m 755 claude-switch /usr/local/bin/
eval "$(claude-switch --shell-config)"

Documentation

• Quick Start
• Install Options
• Full README

v1.5.3

Installation

Homebrew (macOS/Linux)

brew tap FlorianBruniaux/tap
brew install cc-copilot-bridge
eval "$(claude-switch --shell-config)"

Debian/Ubuntu (.deb)

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v1.5.3/claude-switch_1.5.3.deb
sudo dpkg -i claude-switch_1.5.3.deb
eval "$(claude-switch --shell-config)"

RHEL/Fedora (.rpm)

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v1.5.3/claude-switch-1.5.3-1.*.rpm
sudo rpm -i claude-switch-1.5.3-1.*.rpm
eval "$(claude-switch --shell-config)"

Manual Installation

wget https://github.com/FlorianBruniaux/cc-copilot-bridge/archive/refs/tags/v1.5.3.tar.gz
tar xzf v1.5.3.tar.gz
cd cc-copilot-bridge-*
sudo install -m 755 claude-switch /usr/local/bin/
eval "$(claude-switch --shell-config)"

Documentation

• Quick Start
• Install Options
• Full README

v1.3.0 - Documentation & Visual Examples

💰 Cost Impact

• 99.3% savings vs Anthropic Direct ($1,500/month → $10/month)
• Unlimited AI coding for flat $10/month (no per-token billing)

🎯 What's New in v1.3.0

Documentation Overhaul

• TL;DR added: Technical summary for quick understanding
• GitHub optimization: Front-loaded cost savings (line 28 vs 101)
• Confident positioning: "Serving Copilot Pro+ subscribers specifically"

Visual Examples (6 Screenshots)

• ✅ Claude Sonnet 4.5 (default model)
• ✅ Claude Opus 4.5 (premium quality)
• ✅ GPT-4.1 (OpenAI)
• ✅ Ollama offline (100% private)
• ✅ Help menu (claude-switch --help)
• ✅ copilot-api proxy server logs

Internal Documentation

• Created claudedocs/ for non-versioned internal docs
• GitHub settings templates (copy/paste ready)
• Marketing templates (Reddit, HN, Twitter)

🚀 Quick Start

curl -fsSL https://raw.githubusercontent.com/FlorianBruniaux/cc-copilot-bridge/main/install.sh | bash
source ~/.zshrc  # or ~/.bashrc

v1.2.0

Release v1.2.0 - MCP Profiles + System Prompts

🎯 Overview

Initial release of cc-copilot-bridge - a multi-provider bridge for Claude Code CLI that enables free access to 25+ AI models via GitHub Copilot Pro+
subscription.

Turn your $10/month Copilot subscription into unlimited Claude Code access with Claude Opus/Sonnet/Haiku, GPT-4.1/5, Gemini, and more.

✨ Key Features

1. Multi-Provider Switching

• Anthropic Direct: Official API, best quality, production-ready
• GitHub Copilot Bridge: Free with Copilot Pro+, 25+ models, unlimited usage
• Ollama Local: 100% private, offline capable, Apple Silicon optimized

2. MCP Profiles System

• Auto-detection: Automatic profile selection based on model
• Strict validation support: GPT-4.1 and Gemini compatibility via dynamic exclusions
• Generated configs: Auto-generated from excludes.yaml source of truth
• Zero manual management: Profiles regenerate automatically

3. System Prompts Injection

• Model identity correction: GPT-4.1 and Gemini identify themselves correctly
• Respects project prompts: Injected via --append-system-prompt
• Customizable: User-defined prompts in ~/.claude/mcp-profiles/prompts/

4. Health Checks & Validation

• Pre-flight checks: Validates provider availability before launch
• Fail-fast: Clear error messages when providers unavailable
• Session logging: Full audit trail with durations and exit codes

5. Dynamic Model Switching

• 25+ models supported: Claude, GPT, Gemini, Grok, Raptor families
• Environment variable control: COPILOT_MODEL and OLLAMA_MODEL
• Pre-configured aliases: ccc-opus, ccc-sonnet, ccc-haiku, ccc-gpt

📦 Installation

# Automated install (recommended)
curl -fsSL https://raw.githubusercontent.com/FlorianBruniaux/cc-copilot-bridge/main/install.sh | bash

# Reload shell
source ~/.zshrc  # or ~/.bashrc

🚀 Quick Start

# Check provider status
ccs

# Use Anthropic Direct (best quality)
ccd

# Use GitHub Copilot (free)
ccc

# Use Ollama Local (100% private)
cco

# Switch models
ccc-opus    # Claude Opus 4.5
ccc-sonnet  # Claude Sonnet 4.5
ccc-haiku   # Claude Haiku 4.5
ccc-gpt     # GPT-4.1

📚 Documentation

• Quick Start Guide - 2-minute setup
• Commands Reference - All available commands
• Model Switching Guide - Dynamic model selection
• MCP Profiles System - Architecture and troubleshooting
• Apple Silicon Optimization - M1/M2/M3/M4 performance tuning
• Troubleshooting Guide - Common issues and solutions

🎁 What's Included

Core Scripts

• claude-switch - Main multi-provider router with health checks
• install.sh - Automated installation with shell aliases
• scripts/mcp-check.sh - MCP server compatibility diagnostics

MCP Profiles System

• ~/.claude/mcp-profiles/excludes.yaml - Source of truth for exclusions
• ~/.claude/mcp-profiles/generate.sh - Profile generator script
• ~/.claude/mcp-profiles/generated/*.json - Auto-generated profiles

System Prompts

• ~/.claude/mcp-profiles/prompts/gpt-4.1.txt - GPT-4.1 identity prompt
• ~/.claude/mcp-profiles/prompts/gemini.txt - Gemini identity prompt

🔧 Technical Details

MCP Compatibility

• Claude models: 100% compatible (permissive validation)
• GPT models: ~80% compatible (strict validation, excludes problematic MCP servers)
• Gemini models: ~80% compatible (strict validation, excludes problematic MCP servers)

Known Incompatibilities

• GPT Codex models (gpt-5.2-codex, etc.): Require /responses endpoint (copilot-api v0.7.0 doesn't support it)
  • Workaround: Use gpt-4.1, gpt-5, or gpt-5-mini instead
• MCP server grepai: Excluded from GPT/Gemini profiles due to schema validation issues

Performance (Apple Silicon)

• Ollama 8K context: 26-39 tok/s (M4 Pro 48GB + Qwen2.5-Coder-32B)
• Ollama 32K context: 8-15 tok/s (slower but works with large projects)
• Copilot/Anthropic: 1-3s response time (cloud-based)

🐛 Known Issues

1. Ollama context size: Default 8K truncates Claude Code's ~60K context

   • Fix: Increase to 32K for large projects (see TROUBLESHOOTING.md)
   • Better: Use Copilot or Anthropic for large projects

2. GPT Codex unavailable: copilot-api doesn't support /responses endpoint

   • Fix: Use compatible models (gpt-4.1, gpt-5, gpt-5-mini)

💡 Why Use This?

Cost Comparison

• Anthropic Direct: $15-20/month (typical usage)
• cc-copilot-bridge: $10/month flat rate (GitHub Copilot Pro+ subscription)
• Savings: ~$5-10/month + unlimited usage

Use Cases

• Production code: ccd or ccc-opus (best quality)
• Daily development: ccc-sonnet (free, balanced)
• Quick questions: ccc-haiku (fastest)
• Proprietary code: cco (100% private, offline)
• Learning: ccc (cost-effective iteration)

📝 Version Information

• Version: v1.2.0
• Release Date: 2026-01-22
• License: MIT
• Platform: macOS / Linux (Bash)
• Dependencies: Claude Code CLI, nc (netcat), jq

🙏 Acknowledgments

Built with:

• Claude Code CLI by Anthropic
• copilot-api by smol-ai
• Ollama by Ollama Team

🔗 Links

• Repository: github.com/FlorianBruniaux/cc-copilot-bridge
• Issues: GitHub Issues
• Documentation: docs/

---

Full Changelog: Initial release (no previous versions)

Contributors: @FlorianBruniaux + Claude (AI pair programmer)