cc-switch-web
by Laliet
⭐️ A cross-platform web-based All-in-One assistant tool for Claude Code, Codex & Gemini CLI, based on CC Switch.
490stars
76forks
Rust
Added 3/15/2026
Installation
# Add to your Claude Code skills
git clone https://github.com/Laliet/cc-switch-webGetting Started
Guides for using ai agents skills like cc-switch-web.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 5/28/2026
{
"issues": [
{
"type": "npm-audit",
"message": "@vitest/coverage-v8: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "@vitest/mocker: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "esbuild: esbuild enables any website to send any requests to the development server and read the response",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "vite-node: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "vitest: Vulnerability found",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-05-28T07:59:54.154Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}cc-switch-web
Web-based CC Switch for Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw & OMO.
🙏 This project is a fork of farion1231/cc-switch by Jason Young. Thanks to the original author for the excellent work. This fork adds Web Server mode for cloud/headless deployment.
Cross-platform web-based All-in-One assistant for Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw & OMO
English | 中文 | Legal Notice | Changelog
About / 项目简介
cc-switch-web is a cross-platform web-based CC Switch for Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, and oh-my-opencode (OMO). It lets you manage providers and host-side configuration from either a desktop app or an authenticated headless Web console.
Whether you're working locally or in a headless cloud environment, cc-switch-web offers a seamless experience for:
- One-click provider switching between OpenAI-compatible API endpoints
- Unified MCP server management across Claude/Codex/Gemini/OpenCode
- Skills marketplace to browse and install Claude skills from GitHub
- System prompt editor with syntax highlighting
- Configuration backup/restore with version history
- OpenCode and OMO configuration UI with presets, model metadata, and OMO Slim support
- OpenClaw configuration center for models, Agents defaults, Environment, Tools, external Provider reconciliation, Workspace, daily memory, and sessions
- Stream health checks and retained history for validating provider streaming responses
- Web server mode for cloud/headless deployment with Basic Auth
Contact /联系
If you have any questions, you can contact me here https://linux.do/t/topic/1217545
Screenshots
| Provider Switching + Local Routing | Usage Dashboard |
|---|---|
 |
 |
| MCP Server Management | Prompt Management |
|---|---|
 |
 |
| Skills Marketplace | Add Provider |
|---|---|
 |
 |
| Configure Provider |
|---|
 |
Features
Core Features
- Multi-Provider Management: Switch between different AI providers (OpenAI-compatible endpoints) with one click
- Unified MCP Management: Configure Model Context Protocol servers across Claude/Codex/Gemini/OpenCode
- Skills Marketplace: Browse and install Claude skills from GitHub repositories
- Prompt Management: Create and manage system prompts with a built-in CodeMirror editor
- OpenCode Provider Presets: Select AI SDK packages, import preset models, fetch model lists, and edit model variants/options
- OMO / OMO Slim UI: Manage oh-my-opencode and oh-my-opencode-slim configuration with structured fields
- OpenClaw Management: Manage additive providers, models, Agents defaults, Environment, Tools, raw JSON5, Workspace, and daily memory with ETag conflict protection and backups
Extended Features
- Backup Auto-failover: Automatically switch to backup providers when primary fails
- Stream Health Check: Test streaming responses and classify common provider errors
- Session Manager: Browse host-side Claude, Codex, Gemini, OpenCode, and OpenClaw sessions with snapshot-bound pagination and protected deletion
- Import/Export: Backup and restore all configurations with version history
- Cross-platform: Available for Windows, macOS, Linux (desktop) and Web/Docker (server)
Quick Start
Option 1: Web Server Mode (Recommended)
Recommended: Use Web Server Mode for headless/cloud deployments and remote access.
Lightweight web server for headless environments. Access via browser, no GUI dependencies.
Method A: Prebuilt Binary (Recommended)
Download precompiled server binary—no compilation required:
| Architecture | Download |
|---|---|
| Linux x86_64 (glibc) | cc-switch-server-linux-x86_64 |
| Linux aarch64 (glibc) | cc-switch-server-linux-aarch64 |
Release page: v0.21.0 downloads
Note (glibc): Binaries are built on Ubuntu 22.04 (glibc baseline).
If you seeGLIBC_2.xx not found, use Docker or build from source.
Check your glibc withldd --version.
One-Line Deploy:
curl -fsSL https://raw.githubusercontent.com/Laliet/cc-switch-web/main/scripts/deploy-web.sh | bash -s -- --prebuilt
Quick fixes:
GLIBC_2.xx not found: use Docker (ghcr.io/laliet/cc-switch-web:latest) or build from source.- Need container-first deployment: run
docker run -p 3000:3000 ghcr.io/laliet/cc-switch-web:latest. - Windows + WSL shared configs: Settings now provides a one-click WSL template path filler in Advanced tab.
Advanced options:
# Custom install directory and port
INSTALL_DIR=/opt/cc-switch PORT=8080 curl -fsSL https://raw.githubusercontent.com/Laliet/cc-switch-web/main/scripts/deploy-web.sh | bash -s -- --prebuilt
# Create systemd service for auto-start
CREATE_SERVICE=1 curl -fsSL https://raw.githubusercontent.com/Laliet/cc-switch-web/main/scripts/deploy-web.sh | bash -s -- --prebuilt
Method B: Docker Container
Docker image published to GitHub Container Registry (ghcr.io):
docker run -p 3000:3000 ghcr.io/laliet/cc-switch-web:latest
⚠️ Note: Docker image name must be lowercase (
laliet, notLaliet)
Advanced Docker options:
# Use the deploy script (custom port/version/data dir/background)
./scripts/docker-deploy.sh -p 8080 --data-dir /opt/cc-switch-data -d
# Build locally (optional)
docker build -t cc-switch-web .
docker run -p 3000:3000 cc-switch-web
Method C: Build from Source
Dependencies: libssl-dev, pkg-config, Rust 1.78+, pnpm (no WebKit/GTK needed)
# 1. Clone and install dependencies
git clone https://github.com/Laliet/cc-switch-web.git
cd cc-switch-web
pnpm install
# 2. Build web assets
pnpm build:web
# 3. Build and run server
cd src-tauri
cargo build --release --no-default-features --features web-server --example server
HOST=0.0.0.0 PORT=3000 ./target/release/examples/server
Web Server Login
- Username:
admin - Password: Auto-generated on first run, stored in
~/.cc-switch/web_password - CORS: Same-origin by default; set
CORS_ALLOW_ORIGINS=https://your-domain.comfor cross-origin (CORS_ALLOW_ORIGINS="*"is ignored). For LAN/private origins, enableALLOW_LAN_CORS=1(orCC_SWITCH_LAN_CORS=1) to auto-allow - Note: Web mode doesn't support native file pickers—enter paths manually
Web Runtime Boundaries
Web mode manages files and processes on the server host, not on the browser device. The runtime capability endpoint (GET /api/capabilities) drives the UI so native-only controls are not presented as working Web features.
| App | Web/headless support |
|---|---|
| Claude, Codex, Gemini | Providers, MCP, prompts, skills, usage, sessions, and local routing on the server host |
| OpenCode | Additive providers plus MCP, prompts, skills, usage, sessions, and local routing |
| OpenClaw | Additive providers, structured/raw configuration, external-provider reconciliation, allowlisted Workspace/daily-memory editing, and sessions |
| OMO / OMO Slim | Provider profiles plus shared OpenCode MCP/Skills storage; no local proxy takeover |
| Claude Desktop | Provider/local-routing profiles only on a supported macOS or Windows server host; no MCP, prompts, skills, usage, or sessions |
Native file dialogs, tray integration, app update, portable-mode controls, environment management, and native endpoint testing remain desktop-only. OpenClaw local routing, MCP, prompts, skills, and usage remain intentionally unsupported because upstream v3.15.0 does not provide those OpenClaw integrations.
Security
Authentication:
- Basic Auth is required for all API requests
- Browser will prompt for credentials (username/password)
- CSRF token is automatically injected and validated for non-GET requests
Security Headers:
- HSTS (HTTP Strict Transport Security) enabled by default
- X-Frame-Options: DENY (prevents clickjacking)
- X-Content-Type-Opti
Frequently Asked Questions
What is cc-switch-web?
cc-switch-web is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Laliet. ⭐️ A cross-platform web-based All-in-One assistant tool for Claude Code, Codex & Gemini CLI, based on CC Switch. It has 490 GitHub stars.
Is cc-switch-web safe to use?
Yes. cc-switch-web passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install cc-switch-web?
Clone the repository with "git clone https://github.com/Laliet/cc-switch-web" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is cc-switch-web written in?
cc-switch-web is primarily written in Rust. It is open-source under Laliet on GitHub, so you can review or fork the full source.
Are there alternatives to cc-switch-web?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cc-switch-web against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
235,006
35,807
JavaScript
AI Agentsai-agentsanthropic
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
198,471
59,735
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
122,081
8,230
Rust
AI Agentsai-toolsclaude-code