Appearance
版本检查与更新
适用对象：工具命令找不到，或界面与接入教程不一致的用户。预计耗时：5 分钟。
工具界面和配置字段会随版本变化。先确认安装的是目标工具本体，再按该工具官方说明更新；连接AI的快速导入命令只配置客户端。
先检查正在使用的版本
| 工具 | 怎么检查 | 官方说明 |
|---|---|---|
| Claude Code | 终端运行 claude --version | Claude Code 安装 |
| Codex CLI | 终端运行 codex --version | Codex CLI |
| Codex App | App 的“关于”或更新菜单 | Codex 官方文档 |
| OpenCode | 终端运行 opencode --version，或看桌面客户端“关于” | OpenCode 2 文档；OpenCode 1 文档 |
| Pi | 终端运行 pi，确认能启动并打开帮助界面 | Pi 官方站 |
| DeepSeek Harness | 查看 dsh 命令或项目发布说明 | Harness 仓库 |
| WorkBuddy | 桌面版“关于”或更新菜单 | WorkBuddy 官方说明 |
| CC Switch | 应用“关于”或 发布页 | CC Switch 官网 |
如果终端提示“找不到命令”，先关闭并重新打开终端，确认安装位置和 PATH。Windows 与 WSL 要分别检查；你在哪个环境运行工具，就在哪个环境执行导入命令。
什么时候更新
- Claude Code 的模型菜单没有显示导入的模型：先看导入器的版本提示；较旧版本可能只配置所选主模型，更新后再导入可获得完整菜单。
- Codex 找不到导入的模型：确认使用的是与导入命令相同的系统用户，再按官方说明更新 Codex。
- CC Switch 不能识别链接里的模型或 API 格式：建议升级到支持这些参数的 v4.0.10 或更新版本，再从主站重新点击 导入到 CCS。
- 其他工具的配置路径或按钮与文档不同：先查对应工具的官方说明，再按本指南的 配置速查表核对地址和协议。
更新后完全退出并重开工具，选择连接AI模型，发送 测试消息。版本号能显示只证明工具已安装，收到模型回复才证明接入成功。
完成检查
目标工具能够重新启动，且能在新会话里选择连接AI模型并收到正常回复。