cc-switch

(★ 128,677)

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

File Explorer

Download Latest Version (.zip)

- - bug_report.yml
  - config.yml
  - doc_issue.yml
  - feature_request.yml
  - question.yml
- - ci.yml
  - claude.yml
  - labeler.yml
  - release.yml
  - stale.yml
  - sync-r2.yml
  - wsl2-nightly.yml
- CODEOWNERS
- dependabot.yml
- FUNDING.yml
- labeler.yml
- pull_request_template.md
- - add-en.png
  - add-ja.png
  - add-zh.png
  - main-en.png
  - main-ja.png
  - main-zh.png
- - claude-codex-routing-guide-en.md
  - claude-codex-routing-guide-ja.md
  - claude-codex-routing-guide-zh.md
  - codex-claude-routing-guide-en.md
  - codex-claude-routing-guide-ja.md
  - codex-claude-routing-guide-zh.md
  - codex-deepseek-routing-guide-en.md
  - codex-deepseek-routing-guide-ja.md
  - codex-deepseek-routing-guide-zh.md
  - codex-desktop-custom-model-visibility-en.md
  - codex-desktop-custom-model-visibility-ja.md
  - codex-desktop-custom-model-visibility-zh.md
  - codex-kimi-routing-guide-en.md
  - codex-kimi-routing-guide-ja.md
  - codex-kimi-routing-guide-zh.md
  - codex-official-auth-preservation-guide-en.md
  - codex-official-auth-preservation-guide-ja.md
  - codex-official-auth-preservation-guide-zh.md
  - codex-unified-session-history-guide-en.md
  - codex-unified-session-history-guide-ja.md
  - codex-unified-session-history-guide-zh.md
  - proxy-guide-zh.md
- - v3.10.0-en.md
  - v3.10.0-ja.md
  - v3.10.0-zh.md
  - v3.11.0-en.md
  - v3.11.0-ja.md
  - v3.11.0-zh.md
  - v3.11.1-en.md
  - v3.11.1-ja.md
  - v3.11.1-zh.md
  - v3.12.0-en.md
  - v3.12.0-ja.md
  - v3.12.0-zh.md
  - v3.12.1-en.md
  - v3.12.1-ja.md
  - v3.12.1-zh.md
  - v3.12.2-en.md
  - v3.12.2-ja.md
  - v3.12.2-zh.md
  - v3.12.3-en.md
  - v3.12.3-ja.md
  - v3.12.3-zh.md
  - v3.13.0-en.md
  - v3.13.0-ja.md
  - v3.13.0-zh.md
  - v3.14.0-en.md
  - v3.14.0-ja.md
  - v3.14.0-zh.md
  - v3.14.1-en.md
  - v3.14.1-ja.md
  - v3.14.1-zh.md
  - v3.15.0-en.md
  - v3.15.0-ja.md
  - v3.15.0-zh.md
  - v3.16.0-en.md
  - v3.16.0-ja.md
  - v3.16.0-zh.md
  - v3.16.1-en.md
  - v3.16.1-ja.md
  - v3.16.1-zh.md
  - v3.16.2-en.md
  - v3.16.2-ja.md
  - v3.16.2-zh.md
  - v3.16.3-en.md
  - v3.16.3-ja.md
  - v3.16.3-zh.md
  - v3.16.4-en.md
  - v3.16.4-ja.md
  - v3.16.4-zh.md
  - v3.16.5-en.md
  - v3.16.5-ja.md
  - v3.16.5-zh.md
  - v3.17.0-en.md
  - v3.17.0-ja.md
  - v3.17.0-zh.md
  - v3.18.0-en.md
  - v3.18.0-ja.md
  - v3.18.0-zh.md
  - v3.19.0-en.md
  - v3.19.0-ja.md
  - v3.19.0-zh.md
  - v3.19.1-en.md
  - v3.19.1-ja.md
  - v3.19.1-zh.md
  - v3.19.2-en.md
  - v3.19.2-ja.md
  - v3.19.2-zh.md
  - v3.20.0-en.md
  - v3.20.0-ja.md
  - v3.20.0-zh.md
  - v3.6.0-en.md
  - v3.6.0-zh.md
  - v3.6.1-en.md
  - v3.6.1-zh.md
  - v3.7.0-en.md
  - v3.7.0-zh.md
  - v3.7.1-en.md
  - v3.7.1-zh.md
  - v3.8.0-en.md
  - v3.8.0-ja.md
  - v3.8.0-zh.md
  - v3.9.0-en.md
  - v3.9.0-ja.md
  - v3.9.0-zh.md
- - README.md
- pi-frontend-uiux-guidelines-zh.md
- pi-live-provider-sync-requirements-zh.md
- pi-native-contract-zh.md
- pi-thinking-level-map-requirements-zh.md
- com.ccswitch.desktop.desktop
- com.ccswitch.desktop.metainfo.xml
- com.ccswitch.desktop.yml
- README.md
- generate-download-manifest.mjs
- rewrite-updater-manifest.mjs
- - AppSwitcher.tsx
  - BrandIcons.tsx
  - CodexOauthAccountQuota.tsx
  - CodexOauthQuotaFooter.tsx
  - ConfirmDialog.tsx
  - CopilotQuotaFooter.tsx
  - DatabaseUpgrade.tsx
  - DeepLinkImportDialog.tsx
  - FirstRunNoticeDialog.tsx
  - FrontendErrorBoundary.tsx
  - IconPicker.tsx
  - JsonEditor.tsx
  - MarkdownEditor.tsx
  - ProviderIcon.tsx
  - SubscriptionQuotaFooter.tsx
  - theme-provider.tsx
  - UpdateBadge.tsx
  - UsageFooter.tsx
  - UsageScriptModal.tsx
  - XaiOauthQuotaFooter.tsx
- - appConfig.tsx
  - claudeDesktopProviderPresets.ts
  - claudeProviderPresets.ts
  - codexProviderPresets.ts
  - codexTemplates.ts
  - codingPlanProviders.ts
  - constants.ts
  - geminiProviderPresets.ts
  - grokBuildProviderPresets.test.ts
  - grokBuildProviderPresets.ts
  - hermesProviderPresets.ts
  - jiekouProviderPresets.test.ts
  - mcpPresets.ts
  - openclawProviderPresets.ts
  - opencodeProviderPresets.ts
  - piModelCatalog.ts
  - piProviderPresets.ts
  - piThinkingProfiles.ts
  - ppioProviderPresets.test.ts
  - universalProviderPresets.ts
  - userAgentPresets.ts
- - UpdateContext.tsx
- - useBackupManager.ts
  - useDarkMode.ts
  - useDebouncedValue.ts
  - useDirectorySettings.ts
  - useDragSort.ts
  - useGlobalProxy.ts
  - useHermes.ts
  - useImportExport.ts
  - useLastValidValue.ts
  - useMcp.ts
  - useOpenClaw.ts
  - usePromptActions.ts
  - useProviderActions.ts
  - useProxyStatus.ts
  - useSessionSearch.ts
  - useSettings.ts
  - useSettingsForm.ts
  - useSettingsMetadata.ts
  - useSkills.helpers.ts
  - useSkills.ts
  - useStreamCheck.ts
  - useTauriEvent.ts
  - useUsageCacheBridge.ts
  - useUsageEventBridge.ts
- - index.ts
- - authBinding.ts
  - clipboard.ts
  - frontendLogger.ts
  - modelsDevAutoSync.ts
  - modelsDevPricing.ts
  - piPromptSlug.ts
  - piPromptTemplate.ts
  - platform.ts
  - requestOverrides.ts
  - updater.ts
  - usageRange.ts
  - userAgent.ts
  - utils.ts
  - version.test.ts
  - version.ts
  - windowActivity.ts
- - env.ts
  - icon.ts
  - omo.ts
  - proxy.ts
  - subscription.ts
  - usage.ts
- - deepClone.ts
  - deepLinkConfigPreview.ts
  - deeplinkRisk.test.ts
  - deeplinkRisk.ts
  - domUtils.ts
  - errorUtils.ts
  - formatters.ts
  - grokBuildConfig.test.ts
  - grokBuildConfig.ts
  - postChangeSync.ts
  - providerCapabilities.test.ts
  - providerCapabilities.ts
  - providerConfigUtils.test.ts
  - providerConfigUtils.ts
  - providerIcon.test.ts
  - providerIcon.ts
  - providerMetaUtils.ts
  - textNormalization.ts
  - tomlUtils.ts
  - usageDisplay.ts
  - uuid.ts
- App.tsx
- index.css
- index.html
- main.tsx
- types.ts
- vite-env.d.ts
- - default.json
- - 128x128.png
  - 128x128@2x.png
  - 32x32.png
  - 64x64.png
  - dmg-background.png
  - icon.icns
  - icon.ico
  - icon.png
  - Square107x107Logo.png
  - Square142x142Logo.png
  - Square150x150Logo.png
  - Square284x284Logo.png
  - Square30x30Logo.png
  - Square310x310Logo.png
  - Square44x44Logo.png
  - Square71x71Logo.png
  - Square89x89Logo.png
  - StoreLogo.png
- - app_config.rs
  - app_store.rs
  - auto_launch.rs
  - claude_desktop_config.rs
  - claude_mcp.rs
  - claude_plugin.rs
  - codex_config.rs
  - codex_history_migration.rs
  - codex_state_db.rs
  - config.rs
  - error.rs
  - gemini_config.rs
  - gemini_mcp.rs
  - grok_config.rs
  - hermes_config.rs
  - init_status.rs
  - lib.rs
  - lightweight.rs
  - linux_fix.rs
  - main.rs
  - model_capabilities.rs
  - openclaw_config.rs
  - opencode_config.rs
  - panic_hook.rs
  - prompt.rs
  - prompt_files.rs
  - provider.rs
  - settings.rs
  - store.rs
  - tray.rs
  - usage_events.rs
  - usage_script.rs
- - app_config_load.rs
  - app_type_parse.rs
  - deeplink_import.rs
  - hermes_roundtrip.rs
  - import_export_sync.rs
  - mcp_commands.rs
  - profile_roundtrip.rs
  - provider_commands.rs
  - provider_service.rs
  - proxy_commands.rs
  - skill_sync.rs
  - support.rs
- - per-user-main.wxs
- .gitignore
- build.rs
- Cargo.lock
- Cargo.toml
- common-controls.manifest
- Info.plist
- tauri.conf.json
- tauri.windows.conf.json
- - AddProviderDialog.test.tsx
  - AppCountBar.test.tsx
  - AppToggleGroup.test.tsx
  - BasicFormFields.test.tsx
  - ClaudeDesktopProviderForm.test.tsx
  - ClaudeFormFields.test.tsx
  - CodexOAuthSection.test.tsx
  - CommonConfigEditor.test.tsx
  - CommonConfigModalBehavior.test.tsx
  - ConfirmDialog.test.tsx
  - DeepLinkImportDialog.test.tsx
  - EditProviderDialog.test.tsx
  - FrontendErrorBoundary.test.tsx
  - FullScreenPanel.test.tsx
  - GlobalProxySettings.test.tsx
  - GrokBuildProviderForm.test.tsx
  - HermesFormFields.test.tsx
  - ImeSafeInput.test.tsx
  - ImportExportSection.test.tsx
  - JsonEditor.test.tsx
  - ManagedAuthStatusError.test.tsx
  - ManagementListSearch.test.tsx
  - McpFormModal.test.tsx
  - ModelDropdown.test.tsx
  - ModelsDevAutoSyncPanel.test.tsx
  - ModelsDevPickerDialog.test.ts
  - OmoFormFields.mergeCustomModelsIntoStore.test.ts
  - openclaw.utils.test.ts
  - OpenClawFormFields.test.tsx
  - OpenClawProviderActions.test.tsx
  - OpenCodeFormFields.test.tsx
  - PiNativePromptResources.test.tsx
  - PiProviderForm.test.tsx
  - PricingEditModal.test.tsx
  - PromptFormPanel.test.tsx
  - PromptPanel.test.tsx
  - ProviderActions.test.tsx
  - ProviderCard.codexAccount.test.tsx
  - ProviderCardLayout.test.ts
  - ProviderForm.codexCatalog.test.ts
  - ProviderForm.codexManagedAccount.test.tsx
  - ProviderList.test.tsx
  - ProviderPresetSelector.test.tsx
  - ProxyTabContent.apps.test.ts
  - ProxyToggle.test.tsx
  - RequestLogTable.test.tsx
  - RoutingActivationBrand.test.tsx
  - SelectContentScroll.test.ts
  - SelectItemIndicator.test.ts
  - SessionManagerPage.test.tsx
  - sessionUtils.test.ts
  - SettingsDialog.test.tsx
  - SkillsPageInstall.test.tsx
  - UnifiedMcpPanel.test.tsx
  - UnifiedSkillsPanel.test.tsx
  - UsageDashboard.test.tsx
  - usageFormat.test.ts
  - UsageTrendChart.test.ts
  - WebdavSyncSection.test.tsx
  - XaiOAuthSection.test.tsx
- - appConfig.test.tsx
  - claudeProviderPresets.test.ts
  - codexChatProviderPresets.test.ts
  - codexReasoningLevelPresets.test.ts
  - codexTemplates.test.ts
  - doubaoSeedPresets.test.ts
  - localeCoverage.test.ts
  - longcatProviderPresets.test.ts
  - managementListLocales.test.ts
  - mimoTokenPlanPresets.test.ts
  - opencodeProviderPresets.test.ts
  - piIcon.test.ts
  - piProviderPresets.test.ts
  - piThinkingProfiles.test.ts
  - qianfanTokenPlanPresets.test.ts
  - subrouterProviderPresets.test.ts
  - therouterOpenCodeOpenClawPresets.test.ts
  - therouterProviderPresets.test.ts
  - toolManagementLocales.test.ts
  - xaiOauthLocales.test.ts
  - xaiOauthProviderPresets.test.ts
- - useAddProviderMutation.test.tsx
  - useApiKeyState.test.tsx
  - useCodexConfigState.catalog.test.ts
  - useCommonConfigSave.test.tsx
  - useDirectorySettings.test.tsx
  - useDragSort.test.tsx
  - useImportExport.extra.test.tsx
  - useImportExport.test.tsx
  - useImportSkillsFromApps.test.tsx
  - useManagedAuth.test.tsx
  - useMcpBulkToggle.test.tsx
  - useMcpValidation.test.tsx
  - useModelState.test.tsx
  - useOpencodeFormState.test.tsx
  - usePromptActions.test.tsx
  - useProviderActions.test.tsx
  - useProxyStatus.test.tsx
  - useSettings.test.tsx
  - useSettingsForm.test.tsx
  - useSettingsMetadata.test.tsx
  - useSkillsBulkToggle.test.tsx
  - useUpdateProviderMutation.test.tsx
- - App.test.tsx
  - SettingsDialog.test.tsx
- - frontendLogger.test.ts
  - keepLastGoodUsage.test.ts
  - modelsDevAutoSync.test.ts
  - piPromptSlug.test.ts
  - piPromptTemplate.test.ts
  - requestOverrides.test.ts
  - sequentialBulkAction.test.ts
  - userAgent.test.ts
- - handlers.ts
  - server.ts
  - state.ts
  - tauriMocks.ts
- - usage.test.ts
- - deepClone.test.ts
  - deepLinkConfigPreview.test.ts
  - errorUtils.test.ts
  - omoConfig.test.ts
  - providerConfigUtils.codex.test.ts
  - providerMetaUtils.test.ts
  - testQueryClient.ts
  - usageDisplay.test.ts
- setupGlobals.ts
- setupTests.ts
.gitattributes
.gitignore
.node-version
CHANGELOG.md
CODE_OF_CONDUCT.md
components.json
CONTRIBUTING.md
deplink.html
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
postcss.config.cjs
README.md
README_DE.md
README_JA.md
README_ZH.md
rust-toolchain.toml
SECURITY.md
session-manager.md
SUPPORT.md
tailwind.config.cjs
tsconfig.json
tsconfig.node.json
vite.config.ts
vitest.config.ts

# Installation Guide

1. Get the code

git clone https://github.com/farion1231/cc-switch

Downloads the entire project code from GitHub to your computer.

cd cc-switch

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.

brew install --cask cc-switch

Installs the pre-built package via Homebrew — no source build required.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

pnpm install

Downloads and installs the libraries listed in package.json.

pnpm dev

Starts the development/run server.

pnpm typecheck

Type this command into your terminal and run it.

pnpm format

Type this command into your terminal and run it.

pnpm format:check

Type this command into your terminal and run it.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

4. Rust

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Rust (rustup) Installing via rustup also installs cargo.

cargo fmt

Type this command into your terminal and run it.

cargo clippy

Type this command into your terminal and run it.

cargo test

Type this command into your terminal and run it.

cargo test test_name

Type this command into your terminal and run it.

cargo test --features test-hooks

Type this command into your terminal and run it.

✅ If cargo build finishes without errors, it worked. The executable is created under target/.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

cc-switch

File Explorer

# Installation Guide

2. Official Install Script

3. Node.js

4. Rust

Today's picks

Was this content helpful?

Recent Feedback

cc-switch

File Explorer

# Installation Guide

2. Official Install Script

3. Node.js

4. Rust

Today's picks

Was this content helpful?

Recent Feedback

Download README