Agents 总览 #

这一页不负责具体安装步骤，而是帮你先选对客户端。你可以把它理解成一个“选型页”：先看自己的工作方式和目标，再决定应该进入 CC-Switch、Claude Code、Codex、Hermes 还是 OpenCode。

这页能帮你做什么 #

• 快速理解当前已支持的几个 Agent 客户端分别适合什么场景
• 根据自己的工作方式选择最合适的入口页
• 减少“随便点一个客户端先配起来，后来才发现不适合”的试错成本

如果你还没决定用哪个客户端 #

可以先用下面这条最简单的判断逻辑：

• 想统一多个客户端的配置入口：先看 CC-Switch 使用指南
• 偏向终端 + 环境变量 + 编辑器协作：先看 Claude Code 接入指南
• 偏向 CLI / App 双入口、代码生成和审查：先看 Codex 接入指南
• 偏向 OpenAI-compatible 配置文件和最小验证链路：先看 Hermes 接入指南
• 偏向工程化、自定义 provider 和项目级配置：先看 OpenCode 接入指南

各客户端适合什么场景 #

CC-Switch #

适合以下情况：

• 你要同时接多个客户端
• 你不想为每个客户端分别维护配置
• 你要给团队提供统一入口

它不是具体客户端，而是统一配置层。很多情况下，你应该先配它，再进入具体客户端页。

Claude Code #

适合以下情况：

• 你在终端或编辑器中工作较多
• 你能够接受通过环境变量控制接入
• 你希望更自然地贴近编辑器工作流

如果你经常在“终端能用、编辑器不生效”之间切换排查，那么这一页会比其他客户端页更值得先看。

Codex #

适合以下情况：

• 你希望同时保留 CLI 和 App 两种入口的选择空间
• 你更看重代码生成、修改和审查场景
• 你想要相对清晰的桌面入口或命令行入口区分

如果你还没决定到底要不要安装桌面端，这一页会帮助你先判断 CLI、App、还是 npx 更适合你。

Hermes #

适合以下情况：

• 你更关注最小配置链路是否能快速跑通
• 你能接受直接编辑配置文件和 .env
• 你想先完成一次明确、可验证的 OpenAI-compatible 接入

它很适合做“先把一条链路跑通”的起点页。

OpenCode #

适合以下情况：

• 你更偏工程化和自定义 provider
• 你愿意在项目里维护显式配置文件
• 你希望把模型和 provider 管理纳入更清楚的工程结构

如果你在团队环境中更注重可维护性和可扩展性，OpenCode 往往会比更轻量的客户端更适合做长期接入方案。

推荐阅读路径 #

路径一：我只想先试一个客户端 #

1. 创建 API Key
2. 快速开始
3. 直接进入最符合你场景的客户端页

路径二：我要同时接多个客户端 #

1. 创建 API Key
2. 快速开始
3. CC-Switch 使用指南
4. 再进入具体客户端页

路径三：我要给团队整理一套接入说明 #

1. 文档地图
2. 创建 API Key
3. CC-Switch 使用指南
4. 各客户端页
5. 常见问题 与 故障排查

如果你已经选错了客户端怎么办 #

这并不是什么大问题。更好的处理方式是：

1. 不要急着把所有配置都删掉
2. 回到这页，重新判断自己的工作方式和目标
3. 只切换到一个更合适的客户端重新验证

真正浪费时间的不是“第一次选错”，而是“选错后同时乱改多个客户端”。

相关链接 #

• 返回首页
• 文档地图
• 快速开始
• 接入检查清单
• 团队落地建议
• CC-Switch 使用指南
• Claude Code 接入指南
• Codex 接入指南
• Hermes 接入指南
• OpenCode 接入指南