CC Switch

CC Switch is an open-source, cross-platform desktop application (macOS, Windows, Linux) for managing the configuration of Claude Code, Codex CLI, and OpenCode configurations from a single graphical interface. Instead of manually editing ~/.claude/settings.json or ~/.codex/config.toml manually, you can save your Hostlinku provider profile, fetch an automatic list of models from /v1/models, and switch between models/keys with just one click (or from the system tray icon).

Install CC Switch

Select the installation method based on your operating system: macOS (Homebrew):

brew tap farion1231/ccswitch
brew install --cask cc-switch

Or download the .dmg / .tar.gz file from GitHub Releases. Windows: Download the installer CC-Switch-v*-Windows.msi or the portable .zip version from GitHub Releases. Linux:

# Arch Linux (AUR)
paru -S cc-switch-bin

For Ubuntu/Debian/Fedora and other distributions, download the .deb, .rpm, or .AppImage package from GitHub Releases.

One-click quick import (Deep Link)

CC Switch supports the ccswitch://v1/import protocol. After CC Switch is installed, run the following command in the terminal (or open the URL in a browser) to automatically fill out the Hostlinku provider form —all you need to do is paste the sk-… API key into the confirmation dialog. Import the Hostlinku preset for Claude Code:

# macOS: open "ccswitch://..." | Linux: xdg-open "ccswitch://..." | Windows: start "" "ccswitch://..."
open "ccswitch://v1/import?resource=provider&app=claude&name=Hostlinku&homepage=https%3A%2F%2Fhostlinku.com&endpoint=https%3A%2F%2Fapi.hostlinku.com&model=claude-sonnet-4-6&haikuModel=deepseek-v4-1-flash&sonnetModel=claude-sonnet-4-6&opusModel=claude-opus-4-6"

Import the Hostlinku preset for Codex CLI:

open "ccswitch://v1/import?resource=provider&app=codex&name=Hostlinku&homepage=https%3A%2F%2Fhostlinku.com&endpoint=https%3A%2F%2Fapi.hostlinku.com%2Fv1&model=gpt-5-5"

Connect Claude Code via CC Switch

Connect the Codex CLI via the CC Switch

Troubleshooting

Symptoms	Causes & Solutions
The CC Switch setting has no effect in Claude Code	There are still Anthropic OAuth login sessions or `ANTHROPIC_*` variables in `~/.zshrc`. Run `/logout` inside `claude` and clear the old exports in the shell.
The Auto-Fetch Models button failed	Ensure that the Request URL is set to `https://api.hostlinku.com` (without double slashes) and that the API Key is entered correctly.
Codex rejects shell tools once enabled	The model selected in the Codex tab must be a `gpt-` model that is Responses-native* (such as `gpt-5-5`, `gpt-6-astra`, `gpt-6-sol`). Do not select non-OpenAI models or `gpt-5-6-terra` for Codex.
`400 not available in Service Mode`	The selected model is not active for that Service Mode API key. Use the Auto-Fetch Models button to display only models that match that key.

Related guides: Claude Code · Codex · DeepSeek Harness · OpenCode.

Start

Models & Features

API

Account

Help

Install CC Switch

One-click quick import (Deep Link)

Connect Claude Code via CC Switch

Connect the Codex CLI via the CC Switch

Troubleshooting