开始前,先理解这三样东西
ChatGPT 或 Claude Code
你真正用来写代码、问问题的 AI 工具。ChatGPT App 已包含编程能力;也可以使用 Claude Code,两个都装也可以。
CC Switch
一个本地配置管理工具,负责把本站的连接信息写入 ChatGPT 或 Claude Code,省去手动修改文件。
ChatGPT App 和 Claude Code 怎么用
两者都是让 AI 帮你理解和修改代码的工具。先选一个熟悉即可,不需要同时学会两个。
ChatGPT App
ChatGPT 已整合编程能力。打开官方 ChatGPT 桌面应用,进入编程功能,选择要处理的本地项目文件夹,然后在对话框直接说清楚任务,例如“帮我修复登录按钮”或“解释这个报错”。它会读取项目并给出修改建议或代码变更,确认后再应用。
Claude Code
它主要在终端中使用。打开终端,先进入项目目录,再运行 claude。首次使用按提示登录;进入对话后直接描述要做的事。它执行文件修改或命令前会请求许可,新手先阅读提示并确认操作范围即可。
Claude Code 最短使用流程
cd 你的项目文件夹
claude
> 请先解释这个项目的目录结构,再告诉我入口文件在哪里
启动后,直接在 > 后输入自然语言任务即可。需要帮助时输入 /help;结束本次会话可输入 /exit,或直接关闭终端。
第一步:下载并安装 ChatGPT、Claude Code 与 CC Switch
- 下载 ChatGPT App 或 Linux 命令行版本macOS / Windows 桌面端请从 ChatGPT 官方下载页 获取;Linux 或命令行使用请看 ChatGPT 官方 CLI 使用说明。官方站点需要可访问官方网络环境。
- 没有官方网络环境时可访问 codexapp.agentsmirror.com 下载对应版本。安装完成后,至少成功打开一次 ChatGPT App 或命令行版本。
- Claude Code 也可单独使用如更习惯命令行,可按 Claude Code 官方说明安装并至少启动一次。
- 安装 CC Switch前往 CC Switch 官网 或 GitHub Releases,下载与你的 Windows、macOS 或 Linux 系统匹配的安装包。
- 打开一次 CC Switch首次打开时,按界面提示允许它识别本机已安装的 ChatGPT 或 Claude Code。这里不需要填写本站 Key。
第二步:在本站创建个人密钥
- 登录 ZPIKA 控制台打开 API 密钥页面,点击新建密钥。
- 给密钥取一个容易识别的名字例如
我的电脑-CCS。一个设备或一种用途使用一把 Key,日后停用或排错会更方便。 - 默认使用 ChatGPT 分组新建令牌默认分配到 ChatGPT 对应分组(控制台中仍可能显示原分组名称),用于 ChatGPT 或命令行版本接入时通常无需额外调整。
- 需要其它模型时,先看模型广场打开模型广场查看每个可选分组包含哪些模型、对应什么用途以及调用倍率。确认需要的模型后,再把密钥调整到匹配的分组。
- 在密钥选项中选择 CC Switch创建后,在该 Key 的选项里选择
CCS/CC Switch。页面会弹出或提供一键配置入口。
不同分组的可用模型和调用倍率不同,先在模型广场确认再调整。不要把 Key 复制到公开位置;正常情况下,你只需要通过一键配置入口把它交给本机的 CC Switch。
第三步:导入到 CC Switch
- 点击本站弹窗中的导入按钮浏览器可能会询问是否允许打开 CC Switch;请选择允许 / 打开。
- 在 CC Switch 中确认保存它会带入本站的连接信息和你的 Key。确认目标工具是 ChatGPT 或 Claude Code,然后保存为当前配置。
- 完全退出正在运行的工具关闭当前终端、ChatGPT 或 Claude Code 会话,再重新打开。多数命令行工具会在启动时读取新配置。
推荐顺序
1. 先安装 ChatGPT 或 Claude Code
2. 再安装并打开 CC Switch
3. 在本站新建 Key,选择 CCS
4. 允许浏览器唤起 CC Switch 并保存
5. 重启 ChatGPT 或 Claude Code
第四步:确认已经连通
重新打开你使用的工具,创建一个新会话,输入一个简单任务,例如“请用一句话说明这个项目的作用”。能正常收到回复,就表示配置已生效。
- 新终端或新会话里能正常发起请求。
- CC Switch 中当前选中的配置是刚刚导入的 ZPIKA 配置。
- 没有把 API Key 粘贴到对话内容、代码仓库或截图中。
可选:在 ChatGPT App 里调用外部生图
gpt-image-2。
下面是一种让 ChatGPT App 帮你在本机项目目录里测试生图的办法。它不是内建的图片按钮,而是由 ChatGPT 根据配置文件生成并运行一个调用图片接口的小工具。
- 准备图片模型 Key在模型广场确认
gpt-image-2所属的图片分组与倍率,再创建或调整一把图片模型 Key。 - 在项目根目录新建配置文件创建
image-gen-env.txt,仅保存在自己的电脑中,并将它加入.gitignore,避免 Key 被提交到仓库。
# image-gen-env.txt
base_url=[直连域名]
api_key=sk-你的图片模型Key
image_model=gpt-image-2
out_path=/你的图片输出文件夹
- 让 ChatGPT 写一个首次测试工具在 ChatGPT App 中告诉当前可用的推理模型(例如
gpt-5.5):“读取image-gen-env.txt,按 ZPIKA 的 图片生成统一接口文档写一个生图测试工具。只读取文件中的api_key,不要依赖OPENAI_API_KEY,不要把 Key 写入日志;请求中使用async: true,保存任务 ID并轮询到完成,再将data[].url对应的图片下载到out_path。” - 先完成一次小测试让它生成一张简单图片并保存到输出目录。首次运行可能需要安装项目依赖;确认它准备执行的命令和改动后再允许。
- 成功后做成可复用 skill继续让 ChatGPT 在当前项目中创建名为
imagegen-preview的 skill:以后读取同一份image-gen-env.txt,接收提示词,调用图片接口,并输出或展示保存后的图片路径。
gpt-image-2
适合先跑通上面的流程。Gemini 与 GPT Image 均使用 OpenAI Images 兼容格式,详情见图片生成统一接口。
banana / Gemini 生图
需要对应的图片分组 Key。把图片接口 AI 接入规范交给 ChatGPT;Gemini 图片模型也走 OpenAI Images 格式,不要再使用 Gemini 原生请求路径。
其他国内 Agent 客户端:手动接入
除 ChatGPT、Claude Code、Gemini 外,其他支持自定义兼容接口的 Agent 客户端同样可以使用本站。本站令牌页的 CCS 一键配置目前只覆盖 ChatGPT、Claude Code 与 Gemini;以下客户端请在各自的“自定义 Provider / 模型提供商 / API 设置”中手动填写。
DeepSeek Harness(DSH)
DeepSeek 的开源 Agent Harness,适合通过 Profile 和插件组合运行。参考 DSH 官方页面寻找自定义 Provider 配置入口。
Kimi Code
月之暗面的编程 Agent,覆盖桌面端、CLI 与 IDE 插件。参考 Kimi Code中的模型提供商或 API 设置。
智谱 GLM Coding
智谱的 GLM Coding Plan / Agent 工具生态。若客户端提供自定义兼容接口配置,可参考 Z.ai Coding 快速开始的接入概念进行设置。
手动填写这三项
- Base URL填写
[直连域名];若客户端要求将版本路径一并填写,则使用[直连域名]/v1。 - API Key填写本站创建的 Key,并确保 Key 已调整到要使用模型对应的分组。
- 模型在模型广场确认该分组可用模型后,按模型 ID 原样填写。例如文本模型可填当前 Key 所在分组展示的模型 ID。
可选增强:Codex++
如果你使用的是官方 ChatGPT 桌面应用,并希望增加供应商管理、会话管理或界面增强等能力,可以在官方应用安装并能正常启动后,再考虑安装开源项目 Codex++。
常见问题
点了 CCS 后没有弹出 CC Switch?
先确认 CC Switch 已安装并至少打开过一次;然后在浏览器地址栏附近查看是否拦截了“打开外部应用”的请求,选择允许后再试。仍无效时,回到密钥选项重新生成一键配置入口。
导入成功后,ChatGPT 或 Claude Code 还是走旧配置?
请完全退出工具和终端后重新打开,并在 CC Switch 确认刚导入的配置处于当前启用状态。不要同时手动编辑同一份配置文件,以免被工具覆盖。
中转站的号池变化会让我的历史会话消失吗?
不会。会话记录保存在你的本地设备中,不会因为中转站某个上游账号不可用而消失。中转站使用多个上游账号;只要你的 Key 仍有效且有余额,就可以继续使用。即使之后切换为自己的 GPT 账号,原有本地会话数据仍会保留。
我可以把同一把 Key 发给朋友吗?
不建议。Key 会计入你的账户用量,也难以追踪问题。请让每位使用者在自己的账户中创建并管理自己的 Key。
想恢复官方登录怎么办?
在 CC Switch 中切换回官方配置,再按 ChatGPT 或 Claude Code 的官方登录流程登录即可。保留不同配置,日后可以随时切回 ZPIKA。