cc-copilot-bridge

TL;DR: Bash script that routes Claude Code CLI through multiple AI providers. Switch between Anthropic Direct API, GitHub Copilot (via copilot-api proxy), or Ollama local with simple aliases (ccd, ccc, cco).

📖 New to Claude Code? Check out the Claude Code Ultimate Guide for comprehensive documentation, tips, and best practices.

Multi-provider routing for Claude Code CLI

Use your existing GitHub Copilot subscription with Claude Code, or run 100% offline with Ollama. Access Claude, GPT, and Gemini models through a unified interface.

🌐 View Landing Page • Quick Start • Pricing & Limits • Features • Risk Disclosure

🎯 What Is This?

A multi-provider router for Claude Code CLI that lets you switch between AI backends with simple aliases.

Three Providers, One Interface

Provider	Command	Use Case	Cost Model
Anthropic Direct	`ccd`	Production, maximum quality	Pay-per-token
GitHub Copilot	`ccc`	Daily development	Premium requests quota
Ollama Local	`cco`	Offline, proprietary code	Free (local compute)

Architecture Overview

┌─────────────────────────────────────────────────┐
│           Claude Code CLI                       │
│         (Anthropic's CLI tool)                  │
└─────────────────┬───────────────────────────────┘
                  │
        ┌─────────▼──────────┐
        │  cc-copilot-bridge │  ◄─── This Tool
        └─────────┬──────────┘
                  │
        ┌─────────┴────────────┌─────────────────┐
        │                      |                 │
    ┌───▼────┐         ┌───────▼────────┐   ┌───▼────┐
    │ Direct │         │ Copilot Bridge │   │ Ollama │
    │  API   │         │  (copilot-api) │   │ Local  │
    └────────┘         └────────────────┘   └────────┘
    Anthropic           GitHub Copilot       Self-hosted
    Pay-per-token       Premium requests     Free (offline)
                        quota system

🚀 Quick Start

Installation

Recommended: Package Managers (clean, dependency-managed, easy updates)

Homebrew (macOS/Linux)

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

Add to ~/.zshrc: eval "$(claude-switch --shell-config)"

Debian/Ubuntu (.deb)

VERSION="1.5.3"  # Check releases for latest
wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v${VERSION}/claude-switch_${VERSION}.deb
sudo dpkg -i claude-switch_${VERSION}.deb
eval "$(claude-switch --shell-config)"

Add to ~/.bashrc: eval "$(claude-switch --shell-config)"

RHEL/Fedora (.rpm)

VERSION="1.5.3"  # Check releases for latest
wget https://github.com/FlorianBruniaux/cc-copilot-bridge/releases/download/v${VERSION}/claude-switch-${VERSION}-1.noarch.rpm
sudo rpm -i claude-switch-${VERSION}-1.noarch.rpm
eval "$(claude-switch --shell-config)"

Add to ~/.bashrc: eval "$(claude-switch --shell-config)"

Alternative: Script Install (if package managers unavailable)

curl -fsSL https://raw.githubusercontent.com/FlorianBruniaux/cc-copilot-bridge/main/install.sh | bash

Full guides:

Package Managers - Recommended method
Quick Start - All installation options
Install Options - Integration with antigen, oh-my-zsh, etc.

Aliases Included

The installer creates ~/.claude/aliases.sh with these commands:

# Core commands (created automatically)
ccd        # Anthropic API (paid)
ccc        # GitHub Copilot (default: Claude Sonnet 4.5)
cco        # Ollama Local (offline)
ccs        # Check all providers

# Model shortcuts (25+ models)
ccc-gpt='COPILOT_MODEL=gpt-4.1 claude-switch copilot'
ccc-opus='COPILOT_MODEL=claude-opus-4.5 claude-switch copilot'
ccc-gemini='COPILOT_MODEL=gemini-2.5-pro claude-switch copilot'

See INSTALL-OPTIONS.md for integration with antigen, oh-my-zsh, zinit, etc.

Usage

# Start with Copilot (free via your subscription)
ccc

# Switch models on-the-fly
COPILOT_MODEL=gpt-4.1 ccc
COPILOT_MODEL=claude-opus-4.5 ccc

# Check status
ccs

Visual Examples:

Claude Sonnet 4.5 (Default):

Claude Opus 4.5 (Premium):

GPT-4.1 (OpenAI):

Ollama Offline (Private):

💰 GitHub Copilot Pricing & Limits

Important: Using Claude Code via Copilot consumes your premium request quota. Usage is NOT unlimited.

Current Plans (January 2026)

Plan	Monthly Cost	Premium Requests	Notes
Copilot Free	$0	50	Limited model access
Copilot Pro	$10	300	Access to most models
Copilot Pro+	$39	1,500	Full model access
Copilot Business	$19/user	300	Organization features
Copilot Enterprise	$39/user	1,000	Custom models, knowledge bases

Model Multipliers

Different models consume different amounts of premium requests per interaction:

Model	Multiplier	Effective Quota (Pro, 300 req)	Effective Quota (Pro+, 1500 req)
GPT-4.1, GPT-4o, GPT-5-mini	0x	Unlimited	Unlimited
Claude Haiku 4.5	0.33x	~900 interactions	~4,500 interactions
Claude Sonnet 4.5	1x	300 interactions	1,500 interactions
Gemini 2.5 Pro	1x	300 interactions	1,500 interactions
GPT-5.1/5.2	1x	300 interactions	1,500 interactions
Claude Opus 4.5	3x	~100 interactions	~500 interactions

Key insight: GPT-4.1 and GPT-4o are free (0x multiplier) on paid plans. Use them for routine tasks to preserve premium requests for Claude/Opus.

Quota Behavior

Quotas reset on the 1st of each month (00:00 UTC)
Unused requests do not carry over
When quota is exhausted, system falls back to free models (GPT-4.1)
Optional: Enable spending budgets for overflow at $0.04/request

Source: GitHub Copilot Plans

🎨 Features

1. Instant Provider Switching (3 characters)

ccd     # Anthropic Direct API (production)
ccc     # GitHub Copilot Bridge (prototyping)
cco     # Ollama Local (offline/private)

No config changes, no restarts, no environment variable juggling.

Help Menu:

Available commands:

ccs / claude-switch status - Check all providers health
claude-switch --help - Full command reference

2. Dynamic Model Selection (40+ models)

Provider	Models	Cost Model
Anthropic	opus-4.5, sonnet-4.5, haiku-4.5	Per token
Copilot	claude-, gpt-4.1, gpt-5, gemini-, gpt-codex*	Premium requests quota
Ollama	devstral, granite4, qwen3-coder	Free (local)

# Switch models mid-session
ccc                     # Default: claude-sonnet-4.5
ccc-opus                # Claude Opus 4.5
ccc-gpt                 # GPT-4.1
COPILOT_MODEL=gemini-2.5-pro ccc  # Gemini

# Ollama models
cco                     # Default: devstral-small-2
cco-devstral            # Explicit Devstral
cco-granite             # Granite4 (long context)

3. GPT Codex & Gemini 3 Models (via Unified Fork - EXPERIMENTAL)

GPT Codex models use OpenAI's /responses endpoint, and Gemini 3 models have thinking support. Both require a fork of copilot-api that combines PR #167 and #170.

⚠️ Important: Codex models are tested and working. Gemini 3 agentic mode is UNTESTED - PR #167 adds thinking support, but may not fix tool calling issues.

Setup:

# Terminal 1: Launch unified fork (auto-clones if needed)
ccunified

# Terminal 2: Use models
ccc-codex         # gpt-5.2-codex ✅ Tested
ccc-gemini3       # gemini-3-flash-preview ⚠️ Experimental
ccc-gemini3-pro   # gemini-3-pro-preview ⚠️ Experimental

Model Status:

Model	Endpoint	Status
`gpt-5.2-codex`	/responses	✅ Tested
`gpt-5.1-codex-mini`	/responses	✅ Tested
`gemini-3-flash-preview`	/chat/completions	⚠️ Agentic untested
`gemini-3-pro-preview`	/chat/completions	⚠️ Agentic untested

What to test for Gemini 3:

# 1. Baseline (should work)
ccc-gemini3 -p "1+1"

# 2. Agentic mode (uncertain - please report results!)
ccc-gemini3
❯ Create a file test.txt with "hello"

Fork source: caozhiyuan/copilot-api branch 'all' | PR #167 | PR #170

📖 Full guide: docs/ALL-MODEL-COMMANDS.md

5. MCP Profiles System (Auto-Compatibility)

Problem: GPT-4.1 has strict JSON schema validation → breaks some MCP servers

Solution: Auto-generated profiles exclude incompatible servers

~/.claude/mcp-profiles/
├── excludes.yaml       # Define problematic servers
├── generate.sh         # Auto-generate profiles
└── generated/
    ├── gpt.json       # GPT-compatible (9/10 servers)
    └── gemini.json    # Gemini-compatible

6. Model Identity Injection

Problem: GPT-4.1 thinks it's Claude when running through Claude Code CLI

Solution: System prompts injection

~/.claude/mcp-profiles/prompts/
├── gpt-4.1.txt        # "You are GPT-4.1 by OpenAI..."
└── gemini.txt         # "You are Gemini by Google..."

Result: Models correctly identify themselves

7. Health Checks & Fail-Fast

ccc
# → ERROR: copilot-api not running on :4141
#    Start it with: copilot-api start

8. Session Logging

tail ~/.claude/claude-switch.log

[2026-01-22 09:42:33] [INFO] Provider: GitHub Copilot - Model: gpt-4.1
[2026-01-22 09:42:33] [INFO] Using restricted MCP profile for gpt-4.1
[2026-01-22 09:42:33] [INFO] Injecting model identity prompt for gpt-4.1
[2026-01-22 10:15:20] [INFO] Session ended: duration=32m47s exit=0

🏗️ Provider Architecture

🎯 GitHub Copilot Bridge

Use Case: Daily coding, prototyping, exploration

ccc                               # Default: claude-sonnet-4.5
ccc-gpt                          # GPT-4.1 (0x multiplier = free)
ccc-opus                         # Claude Opus 4.5 (3x multiplier)
COPILOT_MODEL=gemini-2.5-pro ccc # Gemini

How It Works:

Routes through copilot-api proxy
Uses your Copilot premium request quota (see Pricing & Limits)
Access to 15+ models (Claude, GPT, Gemini families)
Best for: Daily development, experimentation, learning

copilot-api Running:

Screenshot: copilot-api proxy server logs showing active connections

Requirements:

GitHub Copilot Pro ($10/mo) or Pro+ ($39/mo) subscription
copilot-api running locally (copilot-api start)

🎁 BONUS: Ollama Local (Offline Mode)

Use Case: Offline work, proprietary code, air-gapped environments

cco                                          # Default: devstral-small-2
OLLAMA_MODEL=devstral-64k cco               # With 64K context (recommended)
OLLAMA_MODEL=ibm/granite4:small-h cco       # Granite4 (long context, 70% less VRAM)

How It Works:

Self-hosted inference (no internet required)
Free, 100% private
Apple Silicon optimized (M1/M2/M3/M4 - up to 4x faster)
Best for: Sensitive code, airplane mode, privacy-first scenarios

Important: Ollama is architecturally independent from Copilot bridging. It's a separate provider for local inference, not related to copilot-api.

⚠️ Critical: Context Configuration

Claude Code sends ~18K tokens of system prompt + tools. Default Ollama context (4K) causes hallucinations and slow responses.

Create a 64K Modelfile (recommended):

mkdir -p ~/.ollama
cat > ~/.ollama/Modelfile.devstral-64k << 'EOF'
FROM devstral-small-2
PARAMETER num_ctx 65536
PARAMETER temperature 0.15
EOF
ollama create devstral-64k -f ~/.ollama/Modelfile.devstral-64k
OLLAMA_MODEL=devstral-64k cco

Recommended Models (January 2026):

SWE-bench measures real-world agentic coding ability (GitHub issue resolution with tool calling, multi-file editing). High HumanEval scores don't guarantee agentic performance.

Model	SWE-bench Verified	Params	Practical Status	Use Case
devstral-small-2	68.0%	24B	✅ Best agentic (default)	Daily coding, proven reliable
qwen3-coder:30b	69.6%	30B	⚠️ Needs template work	Highest bench, config issues
ibm/granite4:small-h	~62%	32B (9B active)	✅ Long context	70% less VRAM, 1M context
glm-4.7-flash	~65-68% (estimated)	30B MoE (3B active)	⚠️ Ollama 0.15.1+ required	Tool calling fix (v0.15.1)

Benchmark Sources:

Devstral-small-2: Mistral AI - 68.0% SWE-bench Verified
Qwen3-coder: Index.dev - 69.6% SWE-bench Verified
GLM-4.7 full: Z.AI - 73.8% (Flash variant "tier lower", no published bench)

Why Devstral despite lower SWE-bench?

Designed specifically for agentic software engineering tasks (source)
Native architecture for tool calling vs post-training bolt-on (Qwen3)
"Best agentic coding" confirmed in practice (CLAUDE.md testing)
Qwen3 has higher bench but "needs template work" in real usage

⚠️ Models NOT recommended (low SWE-bench despite good HumanEval):

CodeLlama:13b - 40% SWE-bench (no reliable tool calling)
Llama3.1:8b - 15% SWE-bench ("catastrophic failure" on agentic tasks)

Requirements:

Ollama installed (ollama.ai)
Models downloaded (ollama pull devstral-small-2)

Note: Ollama uses GGUF format (universal). For maximum Mac performance with small models (<22B), LM Studio + MLX can be up to 4x faster. However, for models >30B, GGUF becomes more performant. LM Studio is not compatible with claude-switch.

🔄 FALLBACK: Anthropic Direct API

Use Case: Production, maximum quality, critical analysis

ccd

How It Works:

Official Anthropic API
Pay per token ($0.015-$75 per 1M tokens)
Best for: Production code review, security audits, critical decisions

Requirements:

ANTHROPIC_API_KEY environment variable
Anthropic account with billing

📊 Alternatives

For general multi-provider routing, see @musistudio/claude-code-router (31.9k weekly downloads). For a complete open-source alternative, see OpenCode (48k stars).

cc-copilot-bridge specifically serves Copilot Pro+ subscribers who want to use Claude Code CLI with their existing subscription.

📖 Full Competitive Analysis →

🎬 Real-World Workflows

Workflow 1: Quota-Optimized Development

# Use GPT-4.1 for routine tasks (0x multiplier = doesn't consume quota)
ccc-gpt
❯ Build user authentication flow

# Use Claude Sonnet for complex logic (1x multiplier)
ccc
❯ Design database schema

# Use Anthropic Direct for production review (official API)
ccd
❯ Security audit of auth implementation

Workflow 2: Multi-Model Validation

# Compare approaches across models
ccc-gpt       # GPT-4.1 analysis (free)
ccc           # Claude Sonnet analysis (1x)
ccc-opus      # Claude Opus analysis (3x - use sparingly)

Workflow 3: Offline Development

# Work on proprietary code (airplane mode)
cco
❯ Implement proprietary encryption algorithm
# ✅ No internet required
# ✅ Code never leaves machine

📦 What's Included

Component	Description
claude-switch	Main script (provider switcher)
install.sh	Auto-installer
mcp-check.sh	MCP compatibility checker
MCP Profiles	Auto-generated configs for strict models
System Prompts	Model identity injection
Health Checks	Fail-fast validation
Session Logging	Full audit trail

🔧 Requirements

Claude Code CLI (Anthropic)
copilot-api (ericc-ch/copilot-api) for Copilot provider
- ⚠️ Note: Community patch applied to fix issue #174 (reserved billing header). See TROUBLESHOOTING.md for details.
Ollama (optional, for local provider)
jq (JSON processing)
nc (netcat, for health checks)

📚 Documentation

This Project

QUICKSTART.md - 2-minute setup
MODEL-SWITCHING.md - Dynamic model selection guide
MCP-PROFILES.md - MCP Profiles & System Prompts
SECURITY.md - Security, privacy, and compliance guide
OPTIMISATION-M4-PRO.md - Apple Silicon optimization
TROUBLESHOOTING.md - Problem resolution

Claude Code Resources

📖 Claude Code Ultimate Guide - Comprehensive guide to Claude Code CLI
🔗 Ultimate Guide Repository - Complete documentation, tips, and best practices

🎯 Who Should Use This?

Primary Audience

Copilot subscribers who want to use Claude Code CLI with their existing subscription
Multi-model users who want to compare Claude, GPT, and Gemini responses
Developers who want a unified interface across multiple AI providers

Secondary Audience

Privacy-conscious developers who need offline mode for proprietary code (Ollama)
Teams in air-gapped environments who can't use cloud APIs (Ollama)
Production users who need Anthropic Direct API for critical analysis

🚀 Version

Current: v1.5.1

Changelog: See CHANGELOG.md

⚠️ Risk Disclosure

Terms of Service Considerations

This project uses copilot-api, a community tool that reverse-engineers GitHub Copilot's API.

Important disclaimers:

Not officially supported: copilot-api is not endorsed by GitHub, Microsoft, Anthropic, or any AI provider
ToS risk: Using third-party proxies to access Copilot may violate GitHub Copilot Terms of Service
Account suspension: GitHub reserves the right to suspend accounts for ToS violations "at its sole discretion" without prior notice
API changes: This tool may stop working at any time if providers change their APIs
No guarantees: The authors provide no warranty and accept no liability for account suspension or service interruption

Documented Risks

Community reports indicate that:

Accounts using high volumes through third-party proxies have been suspended
Suspensions may affect your entire GitHub account, not just Copilot access
GitHub does not provide a public definition of "excessive usage" or "abuse"

Recommendations

Use Case	Recommended Provider
Production code	Anthropic Direct (`ccd`) - Official API, no ToS risk
Sensitive/proprietary code	Ollama Local (`cco`) - 100% offline, no cloud
Daily development	Copilot (`ccc`) - Understand the risks first
Risk-averse users	Avoid copilot-api entirely

Source: GitHub Terms of Service - API Terms

📖 Credits

copilot-api: ericc-ch/copilot-api - The bridge that makes this possible
Claude Code: Anthropic - The CLI tool we're enhancing
Ollama: ollama.ai - Local AI inference

📄 License

MIT

🔗 Related Projects

By the Same Author

📖 Claude Code Ultimate Guide - Comprehensive guide to mastering Claude Code CLI
- Complete documentation and best practices
- Tips & tricks for productivity
- MCP server integration guides
- GitHub: claude-code-ultimate-guide

Community Tools

copilot-api - GitHub Copilot API proxy (core dependency)
Ollama - Local AI inference platform
awesome-claude-code - Curated list of Claude Code resources

Name		Name	Last commit message	Last commit date
Latest commit History 54 Commits
.github/workflows		.github/workflows
.serena		.serena
Formula		Formula
assets		assets
docs		docs
scripts		scripts
.gitignore		.gitignore
.gitleaks.toml		.gitleaks.toml
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
claude-switch		claude-switch
install.sh		install.sh

License

FlorianBruniaux/cc-copilot-bridge

Folders and files

Latest commit

History

Repository files navigation

cc-copilot-bridge

🎯 What Is This?

Three Providers, One Interface

Architecture Overview

🚀 Quick Start

Installation

Aliases Included

Usage

💰 GitHub Copilot Pricing & Limits

Current Plans (January 2026)

Model Multipliers

Quota Behavior

🎨 Features

1. Instant Provider Switching (3 characters)

2. Dynamic Model Selection (40+ models)

3. GPT Codex & Gemini 3 Models (via Unified Fork - EXPERIMENTAL)

5. MCP Profiles System (Auto-Compatibility)

6. Model Identity Injection

7. Health Checks & Fail-Fast

8. Session Logging

🏗️ Provider Architecture

🎯 GitHub Copilot Bridge

🎁 BONUS: Ollama Local (Offline Mode)

🔄 FALLBACK: Anthropic Direct API

📊 Alternatives

🎬 Real-World Workflows

Workflow 1: Quota-Optimized Development

Workflow 2: Multi-Model Validation

Workflow 3: Offline Development

📦 What's Included

🔧 Requirements

📚 Documentation

This Project

Claude Code Resources

🎯 Who Should Use This?

Primary Audience

Secondary Audience

🚀 Version

⚠️ Risk Disclosure

Terms of Service Considerations

Documented Risks

Recommendations

📖 Credits

📄 License

🔗 Related Projects

By the Same Author

Community Tools

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Contributors 3

Uh oh!

Languages

Packages