核心理念：复用原生 CLI

PinableAgents 不对 AI 能力做二次封装。Claude Code、Codex、Claude、 Gemini、OpenCode — 各家 CLI 各有所长，我们让它们在终端里各尽其用，而不是强行统一。

这是真正的终端原生方案：

• 无需学习新的抽象层
• 直接调用各家 CLI 的全部能力
• 上下文、会话、超时全部复用原生语义
• 切换后端时，原生 CLI 配置完全保留

五大 CLI 概览

CLI	厂商	核心优势	典型场景
Claude Code	Anthropic	深度上下文理解、工程结构感知	复杂重构、Bug 调查、架构分析
Codex	OpenAI	函数调用、代码生成优化	快速实现、自动化脚本
Claude	Anthropic API	超长上下文、推理能力强	多文件协同、深度分析
Gemini CLI	Google	多模态（图像分析）、低价	UI 还原、设计稿转代码
OpenCode	OpenCode	轻量、极速	简单修复、hotfix

Claude Code

Anthropic 官方 CLI，是 PinableAgents 编排层的默认引擎。Claude Code 深度理解工程上下文，能够感知项目结构、依赖关系和代码风格，在复杂的多文件修改场景中表现尤为突出。

核心优势：

• 深度理解工程结构和依赖关系
• 出色的上下文保持能力
• 原生支持文件编辑、Git 操作、终端命令
• 智能的上下文窗口管理

推荐场景： 复杂重构、Bug 根因分析、架构设计、多文件协同修改

Codex CLI

OpenAI 官方 CLI，代码生成经过专门优化。Codex 在将自然语言直接转化为可执行代码方面表现优秀，是快速实现的利器。

核心优势：

• 函数调用（Function Calling）原生支持
• 代码生成质量高
• 支持 o3（旗舰）、o4-mini（轻量）多种模型
• 结构化输出能力强

推荐场景： 快速功能实现、自动化脚本生成、简单修改

Claude（Anthropic API）

通过原生 API 调用的 Claude 模型。拥有超长上下文窗口（200K tokens），在需要处理大量代码文件的场景中独一无二。

核心优势：

• 超长上下文，可同时分析更多文件
• 出色的指令遵循能力
• 深度推理，适合复杂分析任务

推荐场景： 超大代码库分析、跨模块变更、多文件协同

Gemini CLI

Google 官方 CLI，独特的多模态能力是其最大亮点。能直接分析截图、设计稿，在前端开发场景中有不可替代的优势。

核心优势：

• 多模态分析（图像 → 代码）
• 百万级上下文窗口
• 极低的调用成本
• 快速响应（Flash 模型）

推荐场景： UI 还原、设计稿转代码、视觉元素分析、预算敏感型任务

OpenCode

轻量级 CLI，适合快速 hotfix 和简单修复。响应速度快，资源占用低。

核心优势：

• 极速启动
• 低资源占用
• 简单任务的首选

推荐场景： hotfix、简单修改、轻量级验证

能力对比矩阵

能力维度	Claude Code	Codex	Claude	Gemini	OpenCode
上下文窗口	200K	128K	200K	1M+	128K
代码生成	优秀	优秀	优秀	良好	良好
指令遵循	优秀	良好	优秀	良好	一般
多模态	文本+图像	有限	文本+图像	全面	无
中文能力	优秀	良好	优秀	良好	良好
启动速度	中等	中等	中等	快	快
成本	中等	中等	较高	低	低

按任务类型选择

任务类型	推荐 CLI	原因
复杂重构	Claude Code	深度理解工程结构，保持上下文
Bug 调查	Claude Code / Claude	长上下文看到更多代码
架构设计	Claude Code	推理能力强
快速实现	Codex / OpenCode	速度快，成本低
UI 还原	Gemini CLI	多模态分析设计稿
简单 hotfix	OpenCode	轻量极速
多文件协同	Claude Code / Claude	长上下文优势
预算敏感	Gemini CLI / OpenCode	成本低

回退链配置

当主 CLI 不可用时，自动切换到备选：

{
  "fallback_chain": ["claude-code", "codex", "gemini", "opencode"],
  "fallback_policy": {
    "trigger_on": ["rate_limit", "server_error", "timeout"],
    "max_fallbacks": 3,
    "preserve_context": true
  }
}