个人第一次安装 AI Agent CLI，怎样避免配置冲突？
个人开发者在同一台 Mac 安装 Codex、Claude Code、OpenClaw 等工具时，最容易把安装、账号登录、环境变量、Provider 和工作台执行适配混在一起。本文给出从一个真实任务开始的选型顺序，并说明 CC Switch 适合解决什么、不适合解决什么。
直接答案
第一次安装不要追求工具数量。先按任务选择一种 CLI，完成版本、登录和最小任务验证；需要第二套 Provider 时再引入 CC Switch。Mayaai Top 需要另外按“已安装、已发现、可执行”三个层级核对，终端能运行不等于工作台已经适配。
AI 实践 · 01
先按任务类型选工具，不按热度收集工具
Codex、Claude Code、Kimi Code 和 Qoder 都面向编码或工程工作，但账号、模型和交互方式不同；OpenClaw 更接近常驻自动化入口，Hermes偏向自主任务实验，腾讯 QClaw 是桌面一键环境。个人用户最稳妥的起点，是为当前一项真实任务只选一个工具。
- 修改代码：先比较一种编码型 CLI。
- 需要常驻服务或消息入口：再评估 OpenClaw。
- 需要桌面化低门槛环境：核对腾讯 QClaw。
- 没有明确任务的工具暂不安装。
AI 实践 · 02
安装、登录和可工作是三个验收点
安装脚本执行结束，只能说明文件可能已经写入电脑。还要打开新终端检查命令和版本，再完成官方账号认证，并在测试目录运行一个无风险最小任务。任何一步失败，都应留在当前层排错，而不是换一个安装来源继续覆盖。
- 安装证据：官方域名和明确的可执行文件路径。
- 登录证据：官方认证状态，不是复制来的共享 Key。
- 工作证据：测试目录中的最小任务真实完成。
AI 实践 · 03
配置冲突通常来自四个位置
同一工具的 Provider 可能同时出现在 Shell 环境变量、工具自己的配置文件、CC Switch 配置和已经启动的旧终端进程里。界面显示已经切换，但旧进程仍读取原配置，是最常见的假切换。排错时按这四层从外到内检查，不要同时修改。
- 旧终端进程：关闭后打开新终端。
- 环境变量：只检查名称，输出时隐藏值。
- 工具配置文件：确认当前实际读取的位置。
- CC Switch：检查选中的 Provider 和回滚配置。
AI 实践 · 04
CC Switch 管配置，不管理任务结果
CC Switch 适合在明确支持的工具之间保存和切换 Provider，但它不会替代 Codex、Claude Code 等执行器，也不会保存任务状态、人工确认和最终文件。第三方中转服务还会引入数据去向、账号、计费与稳定性问题，默认应从官方 Provider 开始。
- 只为当前使用的工具创建配置。
- 真实 API Key 不进入截图、文档和代码仓库。
- 切换前保留原配置，切换后验证，失败时可以回滚。
- 官方说明没有列出的工具不推断为已兼容。
AI 实践 · 05
Mayaai Top 用三个层级说明真实兼容状态
Mayaai Top 管理的是目标、任务、运行设备、确认和产出，不是把所有本机命令自动变成执行助手。判断兼容要看三个层级：本机是否已安装、运行设备是否已发现、是否存在可执行 Adapter。当前 Codex、Claude Code、OpenClaw 有执行路径；Hermes、Kimi 只有发现定义；Qoder、QClaw 当前未接入。
- 已安装：终端可以找到命令。
- 已发现：运行设备报告了 Provider。
- 可执行：任务产生真实执行记录和产出。
- 工具版本或产品代码变化后需要重新核对。
AI 实践 · 06
用“装、验、切、接”控制安装成本
一个工具从下载到真正进入工作流，可以用四个动作验收：从官方入口安装，验证版本与最小任务，需要时切换 Provider 并保留回滚，最后核对工作台接入层级。每一步都有证据，个人用户才不会把时间消耗在反复重装和猜测配置上。
- 装：只使用官方入口。
- 验：版本、认证、最小任务。
- 切：验证生效并保留回滚。
- 接：区分安装、发现和执行。
SOURCES
参考来源
FAQ
常见问题
Codex 和 Claude Code 可以同时安装吗？
可以，但第一次不建议同时配置。先让一种工具完成真实最小任务，再增加第二种，并分别记录账号、配置位置和工作目录。
有 CC Switch 后还需要保存原配置吗？
需要。切换工具不能代替备份和回滚。至少记录原 Provider、认证方式和配置位置，真实密钥仍保存在受控环境。
为什么 Mayaai Top 能发现工具却不能创建任务？
发现只表示本地助手找到了命令。真正执行还需要对应 Adapter、参数协议和任务结果处理。未适配工具可以继续独立使用。
最安全的安装顺序是什么？
先检查系统和官方文档，再安装一种工具，验证版本、登录和最小任务；有明确多 Provider 需求时才安装 CC Switch；最后连接 Mayaai Top 并核对执行边界。