一键配置

2026/7/28大约 7 分钟

CC-Switch 一键接入指南

傻瓜式操作 — 只需 3 步，即可在 Codex、Claude Code、VSCode 等所有 AI 编程工具中接入 QuickAPI。

第一步：安装 CC-Switch

从 CC-Switch 官网下载并安装。

⚠️ GNU/Linux 用户注意

CC-Switch 主要支持 Windows 和 macOS。如果你是 Ubuntu/Debian 用户（尤其是 ROS 工程师），可能无法安装。请直接跳到手动配置教程。

第二步：添加 QuickAPI 配置

打开 CC-Switch，点击 添加配置，填入以下信息：

配置项	值
配置名称	QuickAPI（或任意名称）
API Base URL	`https://api.quickapi.store/v1`
API Key	你的 API Key
Provider	OpenAI

第三步：选择你要使用的 AI 工具

在 CC-Switch 的工具列表中，点击你要使用的工具旁边的启用按钮即可。

工具	说明	版本
Codex	OpenAI 官方 AI 编程助手	TUI / APP
Claude Code	Anthropic 官方编程工具	TUI / APP
OpenCode	开源 AI 编程工具	TUI / APP
Roocode	VSCode 插件	插件
Codex (VSCode)	VSCode 版 Codex	插件
Claude Code (VSCode)	VSCode 版 Claude Code	插件
Copilot	VSCode Copilot（OpenAI 兼容模式）	插件
Hermes	智能 AI 编程助手	TUI
OpenClaw	开源 AI 编程工具	TUI
MimoCode	轻量级 AI 编程助手	TUI

💡 一键搞定

启用后，CC-Switch 会自动为所选工具配置好 API 地址和 Key，无需再手动修改任何配置文件。

🌐 选择接入节点（自动测速）

CC-Switch 支持同时添加所有节点，自动测速并选择最快的：

操作步骤

在 CC-Switch 中进入 节点管理
依次添加以下 4 个节点：

节点名称	地址	说明
默认（推荐）	`https://api.quickapi.store/v1`	全国通用
北京节点	`https://api-bj.quickapi.store/v1`	华北地区
香港节点	`https://quickapi.lz-0315.com/v1`	海外/港澳台
IX 直链	`https://api-bj.lz-0315.com/v1`	相当于直连北京腾讯云

点击 🔄 自动测速 按钮
CC-Switch 自动测试每个节点的延迟
测速完成后，自动选择最快的节点

💡 建议

开启 自动切换 功能，当当前节点不可用时，CC-Switch 会自动切换到其他可用节点，保证不断线。

📊 用量查询与余额显示

CC-Switch 可以实时显示你的账户余额和流量使用情况。

⚠️ 重要：两种令牌完全不同！

类型	用途	获取位置
API Key	调用 AI 接口	控制台 → API Keys
访问令牌	查询用量/余额	控制台 → 个人安全设置

两者完全不同，请勿混淆！

配置步骤

在 CC-Switch 中点击 用量查询 → 启用
预设模板 选择 NEWAPI
访问令牌：从 QuickAPI 控制台 → 个人安全设置 中复制
粘贴到 CC-Switch 中，保存

🔧 各工具详细配置示例

以下提供每个工具的完整配置示例。使用 CC-Switch 可以自动完成这些配置，但了解底层配置有助于排查问题。

npm / nvm 镜像配置（中国用户）

安装 TUI 版工具前，建议先配置国内镜像加速：

npm 镜像

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry

nvm 镜像

# 设置 nvm 镜像源
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

# Windows (PowerShell)
$env:NVM_NODEJS_ORG_MIRROR="https://npmmirror.com/mirrors/node"

Codex

TUI 版

# 1. 安装（使用国内镜像）
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex

# 2. 配置环境变量
# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

# 3. 启动
codex

配置文件方式

在 ~/.codex/config.toml 中添加：

[api]
base_url = "https://api.quickapi.store/v1"
key = "YOUR_API_KEY"

APP 版

从 OpenAI 官网下载桌面应用，然后在设置中配置：

API Base URL: https://api.quickapi.store/v1
API Key: YOUR_API_KEY

Claude Code

TUI 版

# 1. 安装（使用国内镜像）
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

# 2. 配置环境变量
# Linux / macOS
export ANTHROPIC_BASE_URL="https://api.quickapi.store/v1"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.quickapi.store/v1"
$env:ANTHROPIC_API_KEY="YOUR_API_KEY"

# 3. 启动
claude

配置文件方式

在 ~/.claude/config.json 中添加：

{
  "apiUrl": "https://api.quickapi.store/v1",
  "apiKey": "YOUR_API_KEY"
}

APP 版

从 Anthropic 官网下载桌面应用，然后在设置中配置：

API Base URL: https://api.quickapi.store/v1
API Key: YOUR_API_KEY

OpenCode

TUI 版

# 1. 安装（使用国内镜像）
npm config set registry https://registry.npmmirror.com
npm install -g opencode

# 2. 配置环境变量
# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

# 3. 启动
opencode

配置文件方式

在 OpenCode 配置文件中添加：

{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

APP 版

从官网下载桌面应用，然后在设置中配置：

API Base URL: https://api.quickapi.store/v1
API Key: YOUR_API_KEY

VSCode 插件

Roocode

在 VSCode 设置（settings.json）中添加：

{
  "roocode.apiBaseUrl": "https://api.quickapi.store/v1",
  "roocode.apiKey": "YOUR_API_KEY",
  "roocode.model": "gpt-4o-mini"
}

Codex (VSCode)

{
  "codex.apiBaseUrl": "https://api.quickapi.store/v1",
  "codex.apiKey": "YOUR_API_KEY"
}

Claude Code (VSCode)

{
  "claude.apiBaseUrl": "https://api.quickapi.store/v1",
  "claude.apiKey": "YOUR_API_KEY"
}

VSCode Copilot（OpenAI 兼容插件）

{
  "copilot.openai.apiBaseUrl": "https://api.quickapi.store/v1",
  "copilot.openai.apiKey": "YOUR_API_KEY",
  "copilot.openai.model": "gpt-4o-mini"
}

Hermes

环境变量

# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 Hermes 配置目录中创建或编辑 config.json：

{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

OpenClaw

环境变量

# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 OpenClaw 配置目录中编辑：

{
  "api": {
    "base_url": "https://api.quickapi.store/v1",
    "api_key": "YOUR_API_KEY"
  }
}

MimoCode

环境变量

# Linux / macOS
export OPENAI_BASE_URL="https://api.quickapi.store/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# Windows PowerShell
$env:OPENAI_BASE_URL="https://api.quickapi.store/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

配置文件

在 MimoCode 配置文件中添加：

{
  "api_base": "https://api.quickapi.store/v1",
  "api_key": "YOUR_API_KEY",
  "model": "gpt-4o-mini"
}

应用	类型	说明
AionUi	桌面办公 Agent	免费开源的 Cowork，支持多模型、文件管理和实时预览
Cherry Studio	桌面 AI 客户端	功能强大的 AI 助手客户端，支持多模型对话
DeepChat	AI Agent 客户端	开源全功能 AI Agent 客户端
Memoh	AI 智能体平台	容器化 AI 智能体平台，每个机器人独立容器运行，支持长期记忆与多渠道接入
FluentRead (流畅阅读)	翻译插件	AI 驱动的智能阅读和翻译助手
LangBot	聊天机器人框架	基于大语言模型的聊天机器人开发平台，支持即时通信
LunaTranslator	翻译工具	游戏和文档的实时翻译工具
AstrBot	Agent 聊天机器人	开源的一站式 Agent 聊天机器人平台
Factory Droid CLI	自动化工作流	自动化工作流的 AI 代理工具