🌐 在线文档站 · 📖 教程目录 · 🔑 快速开始 · ❓ 常见问题 · 💬 交流群
AI API 中转站与自定义 API 接入教程
教程配套 API
本仓库适用于任何符合对应协议的 API。还没有测试 Key 时，可以使用 NexoToken 完成教程中的配置与验证。
💡 这个仓库解决什么问题
你是否遇到过:
- 🤔 下载了 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，先按状态码逐项定位。
📖 教程目录
当前共 98 篇中文文档，覆盖 83 款工具、协议、平台与开发框架。不知道选哪个？先打开支持站内搜索的 在线中文文档站，或查看 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 知识库助手](./guides/pro |