llm-api-setup-guides

---

AI API 中转站与自定义 API 接入教程

---

💡 这个仓库解决什么问题

你是否遇到过:

• 🤔 下载了 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 或流式响应异常	通用排错手册

常见搜索问题 FAQ

中转 API 和官方 API 有什么区别？

两者可能使用相同的公开协议，但服务主体、模型范围、计费、数据处理和可用能力不同。先用最小请求验证协议，再核对价格、安全政策和退出方案。

OpenAI-compatible 是否代表所有功能都兼容？

不代表。Chat Completions 成功不等于 Responses、工具调用、图片输入或 Embedding 都可用，应按目标工具逐项测试。

为什么填了 Key 仍然报 401 或 404？

401 通常与认证有关；404 更常见于 Base URL 路径、接口协议或模型 ID 不匹配。不要反复更换 Key，先按状态码逐项定位。

---

2026 年 10 月更新：18 篇工具与实战教程

从热门项目的安装入手，再完成一次可以核对的操作。下列文章分别标明版本与官方来源；选型指南提供测试方法，未使用虚构的速度、准确率或搜索量排行。

教程	主要内容
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 教程总目录 和 兼容性总表。

💬 聊天客户端 guides/chat-clients/

工具	说明	难度	状态
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	⭐⭐	✅ 已发布

⌨️ AI 编程工具 guides/coding-tools/

工具	说明	难度	状态
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 与完整聊天端点	⭐⭐⭐	✅ 已发布

🧠 本地模型 guides/local-models/

工具	说明	难度	状态
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、工具与生产监控	⭐⭐⭐	✅ 已发布

🏠 自部署与知识库 guides/self-hosted/

工具	说明	难度	状态
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	统一模型网关、别名、认证、预算与回退	⭐⭐⭐	✅ 已发布

🔄 自动化与工作流 guides/automation-platforms/

工具	中文用途	难度	状态
n8n 自动化工作流	AI 节点、RAG、Webhook 与凭据管理	⭐⭐⭐	✅ 已发布
Flowise 可视化 AI 编排	Chatflow、Agentflow、RAG 与 API 发布	⭐⭐⭐	✅ 已发布
Langflow 可视化工作流	Flow、组件、RAG 与 Webhook	⭐⭐⭐	✅ 已发布

🧩 效率工具 guides/productivity-tools/

工具	说明	难度	状态
沉浸式翻译	网页、PDF、字幕翻译与自定义 API	⭐	✅ 已发布
Pot 划词翻译	全系统划词、截图 OCR 与 OpenAI 服务	⭐	✅ 已发布
Obsidian Copilot 知识库助手	自定义模型、Vault QA 与 CORS	⭐⭐	✅ 已发布

🧑‍💻 SDK 与开发框架 guides/developer-integration/

文档	中文用途	难度	状态
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、网络限制与回收	⭐⭐⭐	✅ 已发布

🧪 API 测试与调试 guides/api-testing/

文档	解决什么问题	难度	状态
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 变量的实测对照	⭐⭐⭐	✅ 已发布

📚 基础与排错 guides/basics/

文档	解决什么问题
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 排错

📌 想要的工具不在列表里？提交教程需求，请写明工具版本、官网地址和你希望配置的协议。

---

🔑 开始之前:你需要一把 API Key

所有教程都需要 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 ⭐ 是最大的支持——也方便你下次换工具时找回这里。

📄 License

MIT · 教程可自由转载,注明出处即可