AI Agent 工具与 CC Switch

先了解 Codex、Claude Code 这类 AI Agent 工具,再通过 CC Switch 一键导入 API Key、模型和服务地址。

Codex 与 Claude Code 是什么

Codex 和 Claude Code 都是 AI Agent 工具。与只在网页里聊天不同,它们可以在你的电脑上读取项目文件、修改代码、运行命令,并根据结果继续完成后续步骤。

Codex 由 OpenAI 提供,Claude Code 由 Anthropic 提供。两者都适合编程、排查问题和处理项目文件,但使用的配置文件和接入方式不同。

为什么推荐 CC Switch

Agent 工具需要知道三项信息:使用哪个 API Key、调用哪个模型,以及向哪个 Base URL 发送请求。Codex 通常读取 config.toml,Claude Code 则使用 settings.json 或环境变量,新手手动填写时很容易漏字段或重复添加 /v1。

CC Switch 是一款跨平台配置管理工具。通过本站 API Key 页面的一键导入,它会按 Codex 或 Claude Code 的要求自动带入密钥、模型和服务地址,不需要手动查找并编辑配置文件;以后切换模型或服务商时,也可以直接切换已保存的配置。

CC Switch 不是使用 Agent 的必需软件,但对第一次接入的用户更省步骤,也更不容易填错。熟悉配置后,仍可以按照对应工具文档手动设置。

前往 CC Switch 官网

1. 下载 CC Switch

  1. 1打开 CC Switch 发布页,选择最新版本。
  2. 2在页面底部的安装包列表中选择与操作系统和 CPU 架构匹配的文件;不确定时可以把设备信息交给 AI 判断。
CC Switch 发布页安装包列表
在发布页选择适合自己设备的安装包。

2. 使用和导入

2.1 一键导入 CC Switch 配置

目前仅支持 Codex、Claude Code 和 Gemini。

  1. 1登录本站,进入 API Key 页面并创建密钥。
  2. 2填写密钥名称,选择分组后保存密钥。
  3. 3在密钥行的操作菜单中点击 CC Switch 图标。
  4. 4确认导入信息无误后,允许浏览器打开 ccswitch:// 链接并点击导入。
  5. 5在 CC Switch 中启用导入的供应商,然后重启对应 Agent 客户端使配置生效。

点击了解更多分组与计费信息

创建 API Key
在 API Key 页面创建用于导入的密钥。
填写 API Key 名称和分组
填写密钥名称并选择分组。
打开 CC Switch 导入入口
创建密钥后打开 CC Switch 导入入口。
确认 CC Switch 导入信息
导入前检查服务商、模型和端点信息。
启用导入后的 CC Switch 配置
导入成功后启用配置并重启 Agent。

2.2 手动配置 CC Switch

  1. 1打开 CC Switch,点击右上角加号添加模型供应商。
  2. 2选择统一供应商或 Codex 供应商,自定义配置,然后下滑填写具体配置。
  3. 3按照图示填写信息,红框标注项为必填,完成后点击添加。
  4. 4点击启用,并重启对应的 Agent 客户端。
在 CC Switch 中添加供应商
点击加号添加模型供应商。
选择 CC Switch 供应商类型
选择与目标客户端匹配的供应商类型。
填写 CC Switch 模型配置
填写红框标注的必需配置。
启用 CC Switch 模型配置
保存后启用配置并重启客户端。

高级用法