AI 工具选型与配置 ​

本文整理我在 AI Coding 场景里常用的一组工具、配置链路和 Pi Agent 插件。目标不是把工具全列一遍，而是说明每个工具的定位、适用场景，以及它们之间该怎么搭配。

阅读建议：先看“怎么选工具”，再按你的使用场景跳到对应章节。

怎么选工具 ​

CC-switch ​

CC-Switch 是一款跨平台配置管理工具，专为 Claude Code、Codex、Gemini CLI 等设计，可一键切换多套 API 配置（如 Kiro 反代、DeepSeek、智谱等），支持 MCP 管理、速度测试和配置备份。

• 官网 / 项目：GitHub - farion1231/cc-switch
• 使用文档：CC-Switch 完全指南

快速上手 ​

1. 添加并切换 API 配置
   打开 CC-Switch → 在「API 配置」中添加不同供应商（如 Kiro 反代地址 + API Key）→ 在列表中选中要用的配置，一键切换即可，Claude Code 会使用当前选中的配置。

2. 配置备份与多设备
   使用「备份 / 导出」把配置导出为文件，放到坚果云等网盘，在另一台电脑用「导入」恢复，即可实现多设备共用同一套配置。

AIClient-2-API ​

AIClient-2-API 是一款 API 代理服务，将仅限客户端使用的大模型服务（如 Kiro 内置 Claude、Gemini CLI、Qwen Code 等）统一转换为兼容 OpenAI 的接口，便于在 Cherry Studio、Claude Code 等第三方工具中调用。

• 官网 / 项目：GitHub - justlovemaki/AIClient-2-API
• 官方文档：AIClient-2-API 文档

主要能力：协议转换（OpenAI / Claude / Gemini）、多账户池与故障转移、通过 Kiro / Qwen OAuth 等方式使用免费额度、请求日志与审计。支持 Docker 一键部署。

快速上手 ​

1. Docker 部署
   使用官方镜像启动服务（需开放 3003 等端口，建议在可访问 Kiro 的网络环境部署）：

   bash

   docker run -d \
     -p 3003:3000 \
     -p 8085-8087:8085-8087 \
     -p 19876-19880:19876-19880 \
     --restart=always \
     -v "/path/to/configs:/app/configs" \
     --name aiclient2api \
     justlikemaki/aiclient-2-api

2. 接入 Kiro 免费额度
   浏览器访问 http://<服务器>:3003 登录管理后台（默认密码 admin123）→「提供商池管理」选择 claude-kiro-oauth →「生成授权」用 AWS Builder ID 完成 OAuth → 在「配置管理」中设置 API Key，保存后即可在第三方客户端用该 Key 和 Base URL 调用 Claude 模型。

Perplexity AI 搜索 ​

Perplexity AI 是一款 AI 驱动的搜索引擎，用自然语言提问即可获得带引用来源的答案，适合查文档、查 API、查错误信息、做技术调研等场景，比传统关键词搜索更贴近「问人」的体验。

• 官网：https://www.perplexity.ai/

主要能力：自然语言问答、多轮追问、答案附带可点击的引用链接（便于溯源）、支持代码与结构化结果。有免费版与 Pro 订阅，Pro 支持更强模型与更多次数。

快速上手 ​

1. 技术问题 / 报错排查
   把报错信息或问题描述粘贴到搜索框（如「Next.js 14 App Router 中 useSearchParams 在服务端组件报错怎么办」），即可得到步骤说明和官方文档/讨论链接。

2. API 与库的用法
   直接问「某某库的某某 API 怎么用」「和某某的对比」，常能拿到示例代码和文档链接，比在官网翻目录更快。

3. 与本地 AI 配合
   遇到需要最新信息（版本号、官方公告、近期讨论）时，可先用 Perplexity 查最新结果，再把摘要或链接交给 Cursor/Claude Code 做本地实现或代码修改。

Amp ​

Amp（AmpCode）是一款在终端中使用的 AI 编码代理，可直接利用领先大模型做代码生成、深度模式、代码审查等，按使用付费、个人无加价，适合在命令行里快速调用 AI 而不离开终端。

• 官网：https://ampcode.com/home

主要能力：终端内运行、支持 GPT 等先进模型、深度模式与代码审查代理、按量计费。支持 Mac / Linux / Windows，可通过命令行安装并配合现有 Shell 使用。

快速上手 ​

1. 在终端里直接问 AI
   安装 Amp 后，在终端输入自然语言问题或任务描述，即可得到命令、代码片段或分步说明，无需切到浏览器或 IDE。

2. 与 Cursor / Claude Code 分工
   需要快速试命令、查用法时用 Amp；需要改项目代码、多文件编辑时用 Cursor 或 Claude Code，两者可互补。

Warp ​

Warp 是一款面向开发者的现代化终端，主打「代理型终端」（agentic terminal）：在传统终端能力之上集成 AI，支持用自然语言生成命令、解释报错、补全与建议，并具备 Block 式输入输出、IDE 式编辑、多 Shell 支持等，适合希望「在终端里就能问 AI」的日常开发。

• 官网：https://www.warp.dev/

主要能力：自然语言生成与解释命令、内置多模型（OpenAI、Anthropic、Google 等）、Block 输入输出便于导航与分享、400+ CLI 工具智能补全、主题与快捷键可定制。支持 Mac、Linux、Windows，兼容 ZSH、Bash、Fish、PowerShell、WSL。

快速上手 ​

1. 忘记命令时用自然语言问
   在 Warp 里直接输入「怎么查看当前目录下最大的 10 个文件」，由 AI 生成对应命令，确认后执行即可。

2. 报错看不懂时让 AI 解释
   命令报错后，把错误信息交给 Warp 的 AI，可得到原因说明和修改建议，再决定是否重试或改命令。

3. 与 Amp / Cursor 搭配
   Warp 负责日常终端 + 轻量 AI 问询；需要深度编码代理用 Amp；需要改仓库代码用 Cursor，三者可在同一工作流中配合使用。

Amp 与 Warp 对比 ​

简要结论：Warp 是「你的主终端 + 内置轻量 AI」；Amp 是「挂在你现有终端上的深度编码代理」。两者可同时使用：在 Warp 里日常敲命令、问小问题，需要写脚本/做代码审查时在同一个 Warp 窗口里调 Amp 即可。

Claude Code 接入 Kiro 的配置链路 ​

这条链路适合已经有 Kiro 账号、想在本地快速切换 Claude Code 供应商的人。整体拆成三层：Kiro-account-manager 管账号，AIClient-2-API 提供代理服务，CC-Switch 负责在本地切换供应商配置。

注意：这是个人实践记录，依赖第三方工具和代理链路，稳定性与合规性需要自行评估。

准备项 ​

• 可用的 Kiro 账号。
• Kiro-account-manager：https://github.com/chaogei/Kiro-account-manager
• AIClient-2-API：https://github.com/justlovemaki/AIClient-2-API
• CC-Switch：https://github.com/farion1231/cc-switch

参考文章：https://aicoding.csdn.net/696ae1567c1d88441d8d6c69.html

操作步骤 ​

1. 用 Kiro-account-manager 管理多个 Kiro 账号，并导出需要的 token。
2. 在 AIClient-2-API 中新增 Kiro 供应商，把 Kiro 能力转成 OpenAI / Claude 兼容接口。
3. 在 CC-Switch 中新增 Kiro 供应商，使用 AIClient-2-API 提供的 Base URL 和 token。
4. 在 CC-Switch 中切换当前供应商，Claude Code 就能使用对应 API 配置。

配置示例 ​

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "123456",
    "ANTHROPIC_BASE_URL": "http://localhost:3003/",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_REASONING_MODEL": "claude-opus-4-6"
  }
}

使用建议 ​

• 先确认本地代理服务可用，再切换 CC-Switch 配置，排错会更简单。
• 把账号管理、代理服务、供应商切换分成三层，后续替换任意一层都更方便。
• 长期使用时，把常用配置做成固定模板，避免重复手动输入。

Pi Agent 插件清单 ​

Pi Agent 的优点是原生功能简单，扩展机制完善，适合需要精细控制 Agent 上下文的人。如果你需要开箱即用的产品，优先考虑 Claude Code 或 Codex。

引用：https://github.com/ninehills/blog/issues/162

选择原则 ​

1. 尽量减少上下文占用，避免大量注册 Tools。
2. 同类插件优先选更新活跃、功能完整的。
3. 纯显示优化或低副作用插件可以放宽入选标准。

功能扩展类 ​

• npm:pi-mcp-adapter：用 Lazy load 方式加载 MCP 服务器，适合项目级按需启用。
• npm:pi-web-access：支持多个 Provider 的搜索聚合。
• npm:pi-btw：实现 /btw 功能。
• npm:@tintinweb/pi-subagents：SubAgent 实现，占用上下文较少。
• npm:pi-goal：实现 /goal 功能。
• npm:@juicesharp/rpiv-todo：实现 Todo 功能。
• npm:@juicesharp/rpiv-ask-user-question：结构化提问工具，按需启用。
• npm:@plannotator/pi-extension：提供网页可标注的 Plan 文件和 Code Review。
• https://github.com/davebcn87/pi-autoresearch：增加 autoresearch 功能，适合项目级启用。

功能优化和管理类 ​

• npm:@marckrenn/pi-sub-bar：显示订阅用量信息。
• npm:@tmustier/pi-usage-extension：增加 /usage 命令，查看 session 统计。
• git:github.com/fluxgear/pi-thinking-steps：结构化显示思考步骤。
• npm:pi-cache-graph：显示缓存命中率变化，用于 Debug 上下文影响。
• npm:pi-context-usage：增加 /context 命令，显示上下文详情。
• npm:@ramarivera/pi-skill-selector：优化 skill 斜杠选择体验。
• npm:pi-fallback-provider：配置模型 Fallback Chain。
• npm:pi-command-history：用 Ctrl + Up 查找同目录历史 command。
• npm:pi-discord-remote：为每个 session 配置独立 Discord 会话，结束后自动销毁。
• npm:@vanillagreen/pi-extension-manager：禁用而非卸载扩展，按需使用。
• npm:@vanillagreen/pi-session-manager：检索和跳转历史 session。

Agent 行为优化类 ​

• npm:pi-rtk-optimizer：使用 rtk 压缩 Bash Tool 输出。
• npm:pi-caveman：减少冗余输出，适合思维链偏长的模型。
• npm:pi-context-prune：通过 summary / offload 降低上下文占用，建议手动或按需触发。
• npm:@ff-labs/pi-fff：优化文件与内容搜索。
• npm:pi-hashline-readmap：给文件每行增加 Hash Anchor，降低大文件编辑失败概率。

项目级 Skills/MCP 统一管理 ​

在单个 Workspace 内统一管理 Cursor、Claude Code、Kiro 的 Skills 与 MCP，有两种成熟方案：继续用 GUI 工具曲线实现，或换用原生支持项目级的 CLI 工具。

Skills Manager (jiweiyeah) GUI + 自定义工具 ​

项目地址：https://github.com/jiweiyeah/Skills-Manager

在现有 Skills Manager 中通过「自定义工具」把配置指向项目目录，实现项目级管理：

1. 打开 Skills Manager → 「设置」→「自定义工具」 →「添加工具」。
2. 为当前项目添加三条配置（名称可自定，路径选项目根目录下对应文件夹）：
   • Cursor：.cursor/skills/
   • Claude Code：.claude/skills/
   • Kiro：.kiro/steering/
3. 在 Skills 主页只把项目专属 Skills 同步给这三个「项目级自定义工具」，不同步给全局。

优点：不换工具、可视化；缺点：切换项目时需手动调整同步目标，适合长期只做 1～2 个项目的场景。

mcpcm（MCP配置管理标杆，最稳） ​

核心能力：专门为 MCP 跨工具同步打造的 CLI，稳定可靠，原生支持 Cursor、Claude，可通过自定义路径适配 Kiro，同时支持全局和项目级双模式。

• 自动识别已安装的 AI 工具，无需手动找配置路径。
• 支持 MCP 服务器的批量添加、更新、删除，一处修改全端生效。
• 完美支持项目级配置，在项目根目录初始化即可，配置随项目走。

安装

npm install -g @winches/mcpcm

文档：mcpcm 文档

小结 ​

• 如果你的核心问题是“怎么切换配置”，先看 CC-Switch。
• 如果你的核心问题是“怎么把客户端能力代理成统一接口”，先看 AIClient-2-API。
• 如果你的核心问题是“怎么把 Kiro 接入 Claude Code”，看“Claude Code 接入 Kiro 的配置链路”。
• 如果你的核心问题是“怎么挑 Pi Agent 插件”，看“Pi Agent 插件清单”。
• 如果你的核心问题是“怎么查资料和追最新信息”，先看 Perplexity。
• 如果你的核心问题是“终端里怎么和 AI 配合”，看 Amp 和 Warp 的分工。
• 如果你的核心问题是“团队怎么统一 Skills / MCP”，看最后一节的项目级管理方案。