mirror of https://github.com/farion1231/cc-switch.git synced 2026-06-16 13:34:04 +08:00

Files

T

Jason d9c0e4c452 docs: update user manual to v3.12.3 with new features coverage (en/zh/ja)

Add documentation for features introduced since v3.12.0:

New docs:
- 3.4 Session Manager: browse, search, resume, delete sessions
- 3.5 Workspace & Daily Memory: OpenClaw workspace file editing

Updated docs:
- Add Lightweight Mode to interface overview and FAQ
- Add tray submenu structure (providers grouped by app)
- Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses)
- Add Auto-Fetch Models button documentation
- Add Claude Common Config quick toggles
- Add Codex 1M Context Window toggle
- Add Skill backup/restore lifecycle
- Expand Backup Management panel documentation
- Update WebDAV sync to v2 protocol with dual-layer versioning
- Add OpenCode/OpenClaw to quickstart activation table
- Update README version to v3.12.3

All changes synced across en, zh, and ja locales.

2026-04-04 22:53:20 +08:00

3.2 KiB

Raw Permalink Blame History

1.4 快速上手

本节帮助你在 5 分钟内完成首次配置。

第一步：添加供应商

点击主界面右上角的 + 按钮
在「预设」下拉框中选择你的供应商
- 常用预设：智谱 GLM、MiniMax、DeepSeek、Kimi、PackyCode
- 或选择「自定义」手动配置
填写 API Key
点击「添加」

💡 提示：预设会自动填充端点地址，你只需要填写 API Key。

第二步：切换供应商

添加完成后，供应商会出现在列表中。

方式一：主界面切换

点击供应商卡片的「启用」按钮

方式二：托盘快速切换

右键系统托盘图标
直接点击供应商名称

第三步：生效方式

切换供应商后，各 CLI 工具的生效方式不同：

应用	生效方式
Claude Code	✅ 即时生效（支持热重载）
Codex	需要关闭并重新打开终端
Gemini	✅ 即时生效（每次请求重新读取配置）
OpenCode	需要关闭并重新打开终端
OpenClaw	需要关闭并重新打开终端

Claude Code 首次安装提示

如果 Claude Code 首次启动时提示需要登录或显示初始化引导，请在 CC Switch 中开启「跳过 Claude Code 初次安装确认」选项：

打开 CC Switch「设置 → 通用」
开启「跳过 Claude Code 初次安装确认」开关
重新启动 Claude Code

⚠️ 注意：此选项会写入 ~/.claude/settings.json 的 skipIntroduction 字段，跳过官方的新手引导流程。

验证配置

重启后，启动对应的 CLI 工具并输入简单的问题进行测试：

# Claude Code - 启动后输入测试问题
claude
> 你好，请简单介绍一下自己

# Codex - 启动后输入测试问题
codex
> 你好，请简单介绍一下自己

# Gemini - 启动后输入测试问题
gemini
> 你好，请简单介绍一下自己

# OpenCode - 启动后输入测试问题
opencode
> 你好，请简单介绍一下自己

# OpenClaw - 启动后输入测试问题
openclaw
> 你好，请简单介绍一下自己

如果 AI 能正常回复，说明配置成功。

下一步

恭喜！你已经完成了基础配置。接下来可以：

添加更多供应商 - 配置多个供应商方便切换
配置 MCP 服务器 - 扩展 AI 工具的能力
设置系统提示词 - 自定义 AI 的行为
开启代理服务 - 监控用量和自动故障转移

常见问题

切换后不生效？

确保重启了终端或 CLI 工具。配置文件在切换时已经更新，但运行中的程序不会自动重新加载。

找不到预设？

如果你的供应商不在预设列表中，选择「自定义」手动配置。参考添加供应商了解配置格式。

如何恢复官方登录？

选择「官方登录」预设（Claude/Codex）或「Google 官方」预设（Gemini），重启客户端后按登录流程操作。

3.2 KiB Raw Permalink Blame History