命令行与智能体工具
根据使用场景、协议和权限范围选择适合的 AGTCloud 开发工具。
AGTCloud 可以接入命令行智能体、IDE 扩展、桌面客户端和配置管理工具。选择工具时，先确认工作方式和协议，再评估它能够访问的文件、命令和外部服务。
本页用于快速选择教程，不重复各工具的安装和配置步骤。进入具体教程后，请按照其中的 Base URL、鉴权和模型要求完成接入。
智能体工具可能执行本地操作
部分工具能够读取和修改文件、运行 Shell 命令或访问网络。首次接入请使用不含敏感数据的测试目录，关闭自动批准，并从只读任务开始验证。
按工具选择
| 工具 | 使用形态 | AGTCloud 接入协议 | 更适合 |
|---|---|---|---|
| Claude Code | 终端编程智能体 | Anthropic Messages | 已经使用 Claude Code 工作流，希望保留 Messages 与 Content Blocks 结构 |
| Codex | CLI 与桌面 App | OpenAI Responses | 使用 Responses、Typed Items 或 Codex 项目工作流 |
| Gemini CLI | 终端智能体 | Gemini Generate Content | 已经采用 Gemini Contents 与 Parts 结构 |
| Cline | IDE 扩展 | OpenAI Chat Completions | 希望在 VS Code 兼容编辑器或 JetBrains 中审阅智能体操作 |
| Cherry Studio | 桌面聊天客户端 | OpenAI Chat Completions | 需要图形界面的多模型聊天和基础连接验证 |
| OpenClaw | 自托管 Gateway、TUI 与 Control UI | OpenAI Chat Completions | 需要本地 Gateway 和可扩展的个人智能体运行环境 |
| CC-Switch | 本地配置管理工具 | Anthropic Messages、OpenAI Responses | 需要保存并切换 Claude Code 与 Codex 的 Provider 配置 |
| Hermes Agent | 终端智能体 | OpenAI Chat Completions | 需要 Custom Endpoint、终端会话和工具调用工作流 |
协议名称不代表模型厂商。同一个模型可能提供多种协议入口，但工具调用、多模态、推理和上下文能力仍以当前模型的实际支持范围为准。
按任务选择
| 目标 | 建议优先查看 | 选择理由 |
|---|---|---|
| 在终端中完成代码分析和修改 | Claude Code、Codex、Gemini CLI | 三者都有完整的终端工作流，但使用的协议结构不同 |
| 在 IDE 中逐步审阅文件和命令操作 | Cline | 操作计划、文件变化和授权过程集中在编辑器中 |
| 使用图形界面进行普通模型对话 | Cherry Studio | 配置服务商和模型后即可从聊天界面验证连接 |
| 运行本地、自托管智能体 | OpenClaw、Hermes Agent | 提供 Gateway 或 CLI 智能体运行方式，需要更严格的主机权限控制 |
| 管理多套 Claude Code 或 Codex 配置 | CC-Switch | 适合在本机保存并切换 Provider，不替代实际发起请求的客户端 |
| 连接外部工具和数据源 | MCP 接入与安全 | MCP 是客户端与工具服务之间的协议，不等同于模型 API |
接入前确认
1. 确认使用形态
决定需要终端、IDE、桌面聊天还是自托管 Gateway。不要只依据工具名称选择，先确认它能否适应团队的审批和权限管理方式。
2. 确认协议
从模型广场复制当前 API Key 可用的模型 ID，并确认该模型支持教程所要求的 Chat Completions、Responses、Anthropic Messages 或 Gemini Generate Content 入口。
4. 阅读权限说明
核对工具能够访问的目录、命令、网络和外部服务。默认关闭自动批准，只开放完成当前任务所需的最小范围。
分阶段验证
| 阶段 | 建议任务 | 通过标准 |
|---|---|---|
| 基础连接 | 只回复一段固定文本，不调用工具 | 能够返回内容，Provider、Base URL 和模型符合预期 |
| 只读文件 | 读取测试目录中的 README.md 并概括 | 没有写入文件，也没有执行未批准命令 |
| 受控工具 | 执行一项可撤销、影响范围明确的操作 | 客户端展示操作内容并经过确认，结果与预期一致 |
| 项目任务 | 在版本控制保护下处理真实项目 | 变更可审阅、可回退，并能通过项目现有检查 |
不要把“客户端成功启动”当作接入完成。至少要确认实际请求使用了预期的 Provider、模型和协议，并检查工具没有越过授权范围。
常见选择问题
| 问题 | 处理建议 |
|---|---|
| 工具能够对话，但无法调用工具 | 先确认目标模型和协议是否支持工具调用，再检查客户端版本与工具权限 |
| 同一个模型在不同工具中表现不同 | 对比协议、系统提示、工具 Schema、上下文和客户端默认参数 |
| 配置正确但仍请求其他 Provider | 完全重启客户端，并检查用户级配置、环境变量和当前启用的 Provider |
Base URL 返回 404 | 按具体教程确认应填写 API Origin、/v1 Base URL 还是由客户端自动拼接路径 |
| 不确定是否允许自动批准 | 保持关闭；只有在任务、目录和命令边界都明确时再逐项开放 |
| 需要连接数据库、文件系统或业务服务 | 先阅读 MCP 接入与安全，并核对服务来源和权限 |
安全建议
- 从工具官方渠道下载安装包或命令，升级前阅读版本说明；
- 为不同工具使用便于独立停用和审计的 API Key；
- 在版本控制或备份保护下运行会修改文件的任务；
- 不向模型提交密码、客户资料、生产数据或其他非必要敏感信息；
- 检查工具日志、会话导出和崩溃报告中是否包含 Key、路径或业务数据；
- 停止使用工具后，删除其中保存的凭证并撤销不再需要的权限。
如果已经确定工具，请从 CC-Switch 集成教程开始，或直接选择上表中的对应工具。接口字段和响应结构请以 API Reference 为准。