Using OpenVeer in CC-Switch

Introduction

CC-Switch is an open-source desktop application that unifies the management of API provider configurations across multiple AI coding CLI tools such as Claude Code, Codex, and Gemini CLI.
It turns tedious configuration file editing into just a few clicks in a GUI — once a provider is added, you can switch between API services instantly, with no need to edit configuration files by hand.

By connecting OpenVeer through CC-Switch, you can easily configure the OpenVeer service for Claude Code and Codex, and switch freely between multiple providers.

Prerequisites

Before you begin, make sure you have:

1. Installed a supported CLI tool
   At least one supported CLI tool installed, such as Claude Code or Codex CLI

2. Obtained an OpenVeer API Key
   Log in to the OpenVeer Console to get your API key (starts with sk-)

Step 1: Install CC-Switch

Choose the installation method based on your operating system:

macOS

Install via Homebrew (recommended):

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

You can also download the .dmg installer from GitHub Releases. CC-Switch is signed and notarized by Apple, so it can be installed directly (requires macOS 12 or later).

Windows

Download the .msi installer or the portable .zip from GitHub Releases.

Requires Windows 10 or later.

Linux

Download the appropriate package from GitHub Releases:

• Debian / Ubuntu: .deb package
• Fedora / RHEL: .rpm package
• Universal: .AppImage format
• Arch Linux: paru -S cc-switch-bin

Step 2: Add the OpenVeer Provider

At the top of the CC-Switch main window you can switch between different CLI tool groups. Refer to the steps below based on the tool you want to configure.

Configure for Claude Code

1. Switch to the Claude Code group

Select Claude Code at the top of the main window.

2. Open the Add Provider panel

Click the + button at the top-right corner of the main window.

3. Fill in the provider details

Fill out the form as follows:

4. Save the configuration

Click Add to save. OpenVeer will appear in the provider list.

Configure for Codex

1. Switch to the Codex group

Select Codex at the top of the main window.

2. Open the Add Provider panel

Click the + button at the top-right corner of the main window.

3. Fill in the provider details

A Codex provider is configured through two blocks:

Fill in the API key in the auth.json block:

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Fill in the provider config in the config.toml block:

model = "gpt-5.5"
model_provider = "openveer"

[model_providers.openveer]
name = "OpenVeer"
base_url = "https://api.openveer.com/v1"
wire_api = "responses"
requires_openai_auth = true

4. Save the configuration

Name the provider (e.g., OpenVeer) and click Add to save. CC-Switch will automatically validate both the JSON and the TOML.

Step 3: Switch Providers

Once added, you can switch between OpenVeer and other providers at any time:

Switch in the main window

1. Select OpenVeer in the provider list
2. Click the Enable (or Use) button
3. A "Switched successfully" toast confirms the change

Switch from the system tray

CC-Switch stays in the system tray, so you can switch without opening the main window:

1. Click the CC-Switch icon in the system tray
2. Click the target provider name in the menu — it takes effect immediately

Supported Models

After switching to the OpenVeer provider, you can use a variety of models in the corresponding CLI tool:

FAQ

Q1: Switching providers doesn't take effect?

• Claude Code: Supports hot switching — start a new session; if it still doesn't work, restart Claude Code
• Codex: After switching, restart the terminal or Codex

Q2: API key reported as invalid?

1. Make sure the API key starts with sk- and is copied in full with no extra whitespace
2. Go to the OpenVeer Console to confirm the key is active
3. Check that the endpoint URL is correct (Claude Code uses https://api.openveer.com, Codex uses https://api.openveer.com/v1)

Q3: Format error when adding a Codex provider?

CC-Switch validates auth.json (JSON syntax) and config.toml (TOML syntax). Check that:

• Brackets, quotes, and commas in the JSON are complete
• No full-width / smart quotes are used
• Field names in the TOML are spelled correctly

Q4: Which files does CC-Switch modify?

CC-Switch writes to the configuration files of each tool:

• Claude Code: ~/.claude/settings.json
• Codex: ~/.codex/config.toml and ~/.codex/auth.json

CC-Switch automatically backs up these files before switching, so you don't need to edit them by hand.

Q5: How do I view API usage and billing?

Log in to the OpenVeer Console to view API call statistics, token consumption details, and cost trends.

Support and Help

If you run into any issues while using CC-Switch:

• 📚 OpenVeer Documentation Center
• 📚 CC-Switch Project Page
• 💬 Discord Community
• 🐦 Twitter @AIOpenVeer
• 📧 Technical support: zhihong@openveer.com

This documentation is built and hosted on Mintlify, a developer documentation platform.