你是否遇到过:
- 🤔 下载了 Cherry Studio / Chatbox,打开一脸懵,不知道 API Key 往哪填
- 😤 网上教程零散过时,照着配完一堆 401 / 404 报错
- 💸 想用 Claude / GPT 写代码,却卡在海外信用卡和网络环境上
- 🔀 每个工具配置方式都不一样,换个客户端就要重新摸索一遍
本仓库把主流 AI 工具的接入方式全部整理成统一格式的详细教程: 每篇都包含安装、配置、首次验证、安全提醒和常见报错排查,持续更新。
✅ 教程全部按公开标准协议编写,覆盖 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages。使用前请确认服务支持对应工具所需的协议,再替换 Base URL、Key 和模型 ID。
每个高频问题只由一篇主教程负责，减少重复内容，也方便搜索引擎识别页面主题。
| 你正在搜索的问题 | 直接查看 |
|---|---|
| API 中转站是什么、怎么用、怎么选 | 完整选择与使用指南 |
| API Base URL 是什么、该填哪一段 | API 接入基础 |
Codex API Key 配置、Base URL 与 config.toml 怎么写 |
Codex CLI 教程 |
| Claude Code API Key 配置和连接失败排查 | Claude Code 教程 |
| Cursor API Key 与 Override Base URL 怎么设置 | Cursor 教程 |
| Cherry Studio API 地址和密钥填在哪里 | Cherry Studio 教程 |
| 401、404、429、5xx 或流式响应异常 | 通用排错手册 |
两者可能使用相同的公开协议，但服务主体、模型范围、计费、数据处理和可用能力不同。先用最小请求验证协议，再核对价格、安全政策和退出方案。
不代表。Chat Completions 成功不等于 Responses、工具调用、图片输入或 Embedding 都可用，应按目标工具逐项测试。
401 通常与认证有关；404 更常见于 Base URL 路径、接口协议或模型 ID 不匹配。不要反复更换 Key，先按状态码逐项定位。
从热门项目的安装入手，再完成一次可以核对的操作。下列文章分别标明版本与官方来源；选型指南提供测试方法，未使用虚构的速度、准确率或搜索量排行。
| 教程 | 主要内容 |
|---|---|
| REA：逆向分析 | 安装、MCP、静态分析与证据 |
| Superpowers：开发工作流 | 安装、设计、实现与验证 |
| agent-browser：网页操作 | 快照、定位、截图和会话 |
| Repomix：代码上下文 | 筛选、Token、打包与脱敏 |
| Context7：版本文档 | CLI / Skills、MCP 与库版本 |
| FastMCP 4 | 工具开发、Client 与 HTTP |
| Deep Agents | 规划、文件、委派与上下文 |
| Agno 与 AgentOS | 只读工具、Session 与服务 |
| Mem0 长期记忆 | 新增、检索、删除与隔离 |
| E2B 代码沙箱 | 执行、文件、模板与清理 |
| LightRAG | 模型、图谱、索引与查询 |
| MinerU 4 | PDF、OCR 与文档库 |
| Docling | 统一结构、解析与 Markdown |
| MarkItDown | Office、PDF 与格式转换 |
| PDF 解析工具选型 | MinerU / Docling / MarkItDown |
| Firecrawl | v2 API、Scrape 与 Crawl |
| Crawl4AI | 本地浏览器采集与正文清洗 |
| 网页采集与交互选型 | Firecrawl / Crawl4AI / Browser Use |
当前共 139 篇中文文档，覆盖 99 款工具、协议、平台与开发框架。不知道选哪个？先打开支持站内搜索的 在线中文文档站，或查看 GitHub 教程总目录 和 兼容性总表。
| 工具 | 说明 | 难度 | 状态 |
|---|---|---|---|
| Cherry Studio | 多模型桌面客户端，自定义供应商配置完整 | ⭐ | ✅ 已发布 |
| Chatbox | 轻量、本地优先，适合第一次接 API | ⭐ | ✅ 已发布 |
| LobeChat | Web / PWA / Docker，多服务商与扩展能力 | ⭐⭐ | ✅ 已发布 |
| NextChat | 轻量 Web 客户端，适合快速私有部署 | ⭐⭐ | ✅ 已发布 |
| Jan 本地 AI 客户端 | 自定义端点、本地模型与远程兼容接口 | ⭐⭐ | ✅ 已发布 |
| Msty Studio AI 工作台 | 自带 Provider、多模型与知识管理 | ⭐⭐ | ✅ 已发布 |
| TypingMind 网页客户端 | 自定义完整 Endpoint 与 Web 配置 | ⭐⭐ | ✅ 已发布 |
| BoltAI macOS 客户端 | 自定义 OpenAI-compatible Server | ⭐⭐ | ✅ 已发布 |
| ChatWise 桌面客户端 | OpenAI / Anthropic 兼容 Custom Provider | ⭐ | ✅ 已发布 |
| SillyTavern LLM 前端 | 角色聊天与 Custom OpenAI-compatible Endpoint | ⭐⭐ | ✅ 已发布 |
| 工具 | 说明 | 难度 | 状态 |
|---|---|---|---|
| Claude Code | 终端编程代理，Anthropic Messages 兼容配置 | ⭐⭐ | ✅ 已发布 |
| Claude Code 进阶 | CLAUDE.md、Rules、Skills、Hooks 与 Subagents | ⭐⭐⭐ | ✅ 已发布 |
| Codex CLI | 终端编程代理，OpenAI Responses 协议 | ⭐⭐ | ✅ 已发布 |
| Qwen Code | OpenAI / Anthropic / Gemini 多 Provider 终端代理 | ⭐⭐ | ✅ 已发布 |
| Qoder CLI | 内置模型、受控 Custom Models 与 MCP | ⭐⭐ | ✅ 已发布 |
| Gemini CLI | Gemini 原生 API、自定义 Base URL 与安全配置 | ⭐⭐ | ✅ 已发布 |
| Google Antigravity | Agent Manager、模型选择、MCP 与使用边界 | ⭐⭐ | ✅ 已发布 |
| VS Code / GitHub Copilot BYOK | Custom Endpoint、三类协议与功能边界 | ⭐⭐ | ✅ 已发布 |
| Kiro | Specs、Steering、Hooks、MCP 与分阶段执行 | ⭐⭐ | ✅ 已发布 |
| TRAE IDE | Custom Model、Base URL、Agent 验证与版本边界 | ⭐⭐ | ✅ 已发布 |
| Windsurf BYOK | 官方 BYOK 范围、配置、安全与能力边界 | ⭐ | ✅ 已发布 |
| Cursor | BYOK、Override Base URL 与 Agent 限制说明 | ⭐⭐ | ✅ 已发布 |
| Cline | VS Code 编程代理，OpenAI Compatible 接入 | ⭐⭐ | ✅ 已发布 |
| Roo Code（历史资料） | 已停止运营；仅供存量用户迁移与排错 | — | |
| Continue | Chat、Agent、补全、Embedding 分角色配置 | ⭐⭐⭐ | ✅ 已发布 |
| CC Switch | Claude / Codex 等 CLI 配置管理与切换 | ⭐⭐ | ✅ 已发布 |
| Aider 终端编程助手 | Git 驱动的代码编辑与 Chat Completions | ⭐⭐ | ✅ 已发布 |
| OpenCode 终端编程代理 | Chat Completions / Responses 分协议配置 | ⭐⭐⭐ | ✅ 已发布 |
| Crush 终端编程 Agent | OpenAI / Anthropic 兼容 Provider 与工具验证 | ⭐⭐⭐ | ✅ 已发布 |
| OpenHands 软件工程 Agent | Local GUI、自定义模型、Docker 与 Base URL | ⭐⭐⭐ | ✅ 已发布 |
| AionUi 多 Agent 工作台 | Custom 模型、工作区与外部 CLI 边界 | ⭐⭐ | ✅ 已发布 |
| Kilo Code 编程代理 | VS Code、CLI 与自定义 Provider | ⭐⭐ | ✅ 已发布 |
| Zed 编辑器 AI 助手 | Agent、模型能力与协议切换 | ⭐⭐ | ✅ 已发布 |
| goose 开源编程代理 | 声明式 Provider 与完整聊天端点 | ⭐⭐⭐ | ✅ 已发布 |
| 工具 | 说明 | 难度 | 状态 |
|---|---|---|---|
| Ollama | 本地模型、兼容 API、上下文与局域网安全 | ⭐⭐ | ✅ 已发布 |
| LM Studio | 图形化模型管理、API Server、认证与 JIT | ⭐⭐ | ✅ 已发布 |
| vLLM | GPU 推理、OpenAI 兼容接口、工具与安全 | ⭐⭐⭐ | ✅ 已发布 |
| Xinference | LLM、Embedding、Rerank 与统一管理 | ⭐⭐⭐ | ✅ 已发布 |
| llama.cpp / llama-server | GGUF、本地兼容 API、工具、Embedding 与监控 | ⭐⭐⭐ | ✅ 已发布 |
| LocalAI | 多后端、多模态、WebUI 与本地兼容 API | ⭐⭐⭐ | ✅ 已发布 |
| SGLang | GPU 高吞吐推理、Reasoning、工具与生产监控 | ⭐⭐⭐ | ✅ 已发布 |
| 工具 | 说明 | 难度 | 状态 |
|---|---|---|---|
| Open WebUI | Docker 多用户聊天、连接与反向代理 | ⭐⭐⭐ | ✅ 已发布 |
| LibreChat | Custom Endpoints、YAML 与 Docker 部署 | ⭐⭐⭐ | ✅ 已发布 |
| AnythingLLM | 本地文档、工作区与 RAG 完整链路 | ⭐⭐ | ✅ 已发布 |
| Dify | 模型插件、知识库、工作流与应用发布 | ⭐⭐⭐ | ✅ 已发布 |
| FastGPT | 模型渠道、Embedding、知识库与应用 API | ⭐⭐⭐ | ✅ 已发布 |
| RAGFlow 文档知识库 | 模型、数据集、检索与 Agent | ⭐⭐⭐ | ✅ 已发布 |
| MaxKB 企业知识库 | 模型、知识库、智能体与应用发布 | ⭐⭐⭐ | ✅ 已发布 |
| OpenClaw | 自托管助手、Custom Provider、渠道与 Gateway | ⭐⭐⭐ | ✅ 已发布 |
| AstrBot | 多平台机器人、模型 Provider 与插件 | ⭐⭐⭐ | ✅ 已发布 |
| LangBot | 机器人、Pipeline、知识库与 Rerank | ⭐⭐⭐ | ✅ 已发布 |
| LiteLLM Proxy | 统一模型网关、别名、认证、预算与回退 | ⭐⭐⭐ | ✅ 已发布 |
| 工具 | 中文用途 | 难度 | 状态 |
|---|---|---|---|
| n8n 自动化工作流 | AI 节点、RAG、Webhook 与凭据管理 | ⭐⭐⭐ | ✅ 已发布 |
| Flowise 可视化 AI 编排 | Chatflow、Agentflow、RAG 与 API 发布 | ⭐⭐⭐ | ✅ 已发布 |
| Langflow 可视化工作流 | Flow、组件、RAG 与 Webhook | ⭐⭐⭐ | ✅ 已发布 |
| 工具 | 说明 | 难度 | 状态 |
|---|---|---|---|
| 沉浸式翻译 | 网页、PDF、字幕翻译与自定义 API | ⭐ | ✅ 已发布 |
| Pot 划词翻译 | 全系统划词、截图 OCR 与 OpenAI 服务 | ⭐ | ✅ 已发布 |
| Obsidian Copilot 知识库助手 | 自定义模型、Vault QA 与 CORS | ⭐⭐ | ✅ 已发布 |
| 文档 | 中文用途 | 难度 | 状态 |
|---|---|---|---|
| OpenAI Python / Node.js SDK | Responses、Chat、流式、重试与错误处理 | ⭐⭐ | ✅ 已发布 |
| LangChain 开发框架 | Python / TypeScript、Tool Calling 与 Embedding | ⭐⭐⭐ | ✅ 已发布 |
| LlamaIndex RAG 框架 | OpenAILike、向量索引与来源验证 | ⭐⭐⭐ | ✅ 已发布 |
| Vercel AI SDK | Next.js 流式聊天、工具调用与 Provider | ⭐⭐⭐ | ✅ 已发布 |
| Spring AI Java 框架 | Spring Boot、ChatClient 与生产部署 | ⭐⭐⭐ | ✅ 已发布 |
| OpenAI Agents SDK | Responses / Chat、自定义 Provider 与多 Agent | ⭐⭐⭐ | ✅ 已发布 |
| PydanticAI | 结构化输出、工具调用与 OpenAI-compatible API | ⭐⭐⭐ | ✅ 已发布 |
| CrewAI | 多 Agent、任务协作与自定义 LLM | ⭐⭐⭐ | ✅ 已发布 |
| LangGraph | Agent 状态图、工具、记忆与持久化 | ⭐⭐⭐ | ✅ 已发布 |
| Google ADK | 工具、Session、多模型、评测与部署边界 | ⭐⭐⭐ | ✅ 已发布 |
| Claude Agent SDK | Agent 循环、工具权限、Session 与安全部署 | ⭐⭐⭐ | ✅ 已发布 |
| Hugging Face smolagents | CodeAgent、工具、自定义模型与执行隔离 | ⭐⭐⭐ | ✅ 已发布 |
| Langfuse | LLM / Agent Trace、成本、评测与数据脱敏 | ⭐⭐⭐ | ✅ 已发布 |
| MCP Apps | 交互式 MCP UI、资源、iframe 与 CSP | ⭐⭐⭐ | ✅ 已发布 |
| Microsoft Agent Framework | Python Agent、Workflow、Harness 与 A2A | ⭐⭐⭐ | ✅ 已发布 |
| Mastra | TypeScript Agent、Tools、Memory 与 Workflow | ⭐⭐⭐ | ✅ 已发布 |
| Browser Use | 浏览器自动化 Agent、CLI、MCP 与权限 | ⭐⭐⭐ | ✅ 已发布 |
| Daytona | AI 代码 Sandbox、Snapshot、网络限制与回收 | ⭐⭐⭐ | ✅ 已发布 |
| 文档 | 解决什么问题 | 难度 | 状态 |
|---|---|---|---|
| Apifox / Postman 测试 AI API | Models、Chat、Responses、SSE 与状态码排查 | ⭐⭐ | ✅ 已发布 |
| MCP Inspector | MCP Server Web / CLI / TUI 调试与 CI 冒烟 | ⭐⭐⭐ | ✅ 已发布 |
| Promptfoo 自动化评测 | Prompt、模型、Agent 回归测试与 Red Team | ⭐⭐⭐ | ✅ 已发布 |
| Ragas RAG 评测 | 检索、忠实度、回答质量与实验方法 | ⭐⭐⭐ | ✅ 已发布 |
| OrcaReplay 录制与离线重放 | 录下 Agent 与模型服务之间的请求，断网重放；含各框架读哪个 Base URL 变量的实测对照 | ⭐⭐⭐ | ✅ 已发布 |
| 文档 | 解决什么问题 |
|---|---|
| API 中转站选择与使用 | 是什么、怎么用、怎么选、最小验证、安全检查与常见错误 |
| API 接入基础 | Base URL、Key、模型 ID、Chat Completions、Responses、Messages |
| Embedding 与 Rerank | 模型选型、向量维度、两阶段检索、评测与迁移 |
| 订阅、官方 API 与兼容 API 怎么选 | 分清聊天订阅与 API，按聊天、开发、Agent 和私有部署场景决策 |
| 兼容 API 上线验收 | 协议、能力、账单、稳定性、密钥和数据安全评分 |
| Token、上下文与 Agent 成本 | 计算多轮对话、工具循环、RAG 与缓存的真实消耗 |
| 流式、工具与长上下文测试 | SSE、Function Calling、上下文截断、Usage 与 Agent 完整测试 |
| MCP 入门与安全配置 | Tools、Resources、Prompts、最小权限、审批和越界测试 |
| MCP 2026-07-28 | 无状态核心、Discovery、MRTR、Extensions 与迁移 |
| Agent Skills | SKILL.md、渐进加载、触发评测与脚本安全 |
| ACP | 编辑器与编程 Agent 的会话、流式事件和权限 |
| A2A | Agent Card、Task、Artifact 与跨 Agent 协作 |
| API Key 安全与轮换 | 环境变量、CI、容器、无中断轮换和泄露处置 |
| 限流、重试与并发控制 | 429、退避、队列、幂等、流式中断和重试预算 |
| AI 编程用量与成本优化 | ccusage、多工具报表、估算边界、上下文与成本优化 |
| 兼容性总表 | 按场景选工具，判断聊天、Agent、Embedding 和部署要求 |
| 通用排错手册 | 400 / 401 / 403 / 404 / 429 / 5xx、SSE、Docker、RAG 排错 |
📌 想要的工具不在列表里？提交教程需求，请写明工具版本、官网地址和你希望配置的协议。
所有教程都需要 Base URL + API Key + 准确的模型 ID。不同工具使用的协议可能是 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages,请以具体教程为准。获取途径任选:
| 途径 | 优点 | 门槛 |
|---|---|---|
| 官方 API (OpenAI / Anthropic / Google) |
功能最全,第一手 | 海外信用卡 + 网络环境 |
| 聚合 / 中转服务 | 支付宝微信付款,国内直连,一把 Key 调多家模型 | 邮箱注册即可 |
本仓库教程示例使用 纽智中转站 演示。以下活动信息核验于 2026-07-14,后续规则以注册页和控制台实时展示为准:
- 🆓 新注册、未充值账户当前有每日 20 次免费额度,每日北京时间 00:00 重置
- 🧪 未充值账号当前可 ¥1 购买 300 积分体验付费线路,适合低成本走完教程
- 📊 模型广场展示当前可用模型、价格与运行状态,并提供 Claude Code / Codex 兼容模型
💡 同一协议下的核心配置相近,但 Base URL、认证方式和模型能力仍可能不同。多比价、小额试用、按需选择,是这个领域的通用生存法则。
🔴 报错 401 Unauthorized
Key 复制不完整或已删除。回服务商后台重新复制完整 Key,注意首尾不要带空格。
🔴 报错 404 Not Found
Base URL 填错。注意有的工具要填到 /v1 结尾,有的会自动补全,详见各工具教程中的填写说明。
🔴 提示"余额不足"但明明有免费额度
部分服务的免费额度只在特定分组/模型生效。确认调用的模型在免费池内,或检查是否选对了分组。
🟡 响应很慢
先换一个可用模型或稍后重试。若模型与服务商明确支持 prompt caching,长对话中的缓存读取通常比普通输入便宜,具体折扣与生效条件以当前价格文档为准。
- 🐛 教程有错、步骤过时 → 提 Issue
- ➕ 想补充其他工具的教程 → 欢迎 PR
- 💬 配置卡住了想找人问 → QQ 群 822274386,在线必回
如果这些教程帮到了你,点个 Star ⭐ 是最大的支持——也方便你下次换工具时找回这里。
MIT · 教程可自由转载,注明出处即可
由 纽智中转站 维护 · 持续更新中