航海手册
指南
长篇实战教程，帮你把 Claude 生态用到极致。第一批文章正在路上。
- MCP 服务器
MCP 服务器调试：Inspector、抓包与失败模式（2026）
MCP 协议级调试——用 MCP Inspector 驱动服务器、抓 JSON-RPC 流量、stdio 与 HTTP 调试差异、五个真实 bug 复现，外加把可调试性设计进服务器的预防性观测与 2026-07-28 规范升级期排障。
- 技能与命令
把 Claude Code 接入 GitHub Actions：@claude 触发、PR 评审、定时巡检的完整 workflow（2026）
把 Claude Code 接入 GitHub Actions——@claude 提及、PR 评审、cron 三种触发，认证与权限、fork PR secrets 行为、可复制 workflow 模板，外加成本运营四抓手与多仓库推广治理清单。
- MCP 服务器
MCP 服务器 Docker 部署指南：Catalog、Gateway 与 Compose 编排（2026）
2026 年 MCP 服务器容器化部署实战——stdio 与容器常驻的本质矛盾、300+ 签名服务器的 Docker MCP Catalog、docker mcp CLI 与 Gateway（三种 transport / 认证 / 凭据）、Claude Desktop 与 Claude Code 对接、Compose 编排，以及 2026-07-28 无状态化对 K8s 部署的意义。
- MCP 服务器
什么是模型上下文协议（MCP）？从概念到搭建你的第一个服务器（2026）
MCP 2026 实战讲解——它解决了什么、Host/Client/Server 三角关系、tools / resources / prompts 三大原语、stdio 与 Streamable HTTP 传输选型、2026 年生态三层图景（Host / Server / 目录），以及五个高频误区澄清，附 TypeScript 最小服务器实战。
- 技能与命令
Claude Computer Use 实战：让 Claude 直接操作桌面、浏览器与 GUI 应用（2026）
把 Claude 变成视觉 agent 操作任意 GUI——computer 工具、模型与工具版本（computer_20250124）、16 个 action、截图-决策-执行 loop、token 预算、强制隔离沙箱、3 个生产用例，外加六个视觉 agent 翻车点（HiDPI 坐标/沙箱出口/敏感操作）与一套评估质量闸门。
- 提示词库
Claude Extended Thinking 调参实战：从 budget_tokens 到 adaptive thinking 的迁移（2026）
2026 年 Claude 深度推理调参实战——budget_tokens 三条硬规则与摘要式思考计费口径、adaptive thinking 模型支持矩阵（Fable/Mythos 仅 adaptive、5 系默认开启）、effort 五档选型、output_config 位置陷阱、与 prompt caching 的交互，以及迁移决策框架。
- SDK 与工具
用 Claude Agent SDK 搭建自主工作流
如何用 Claude Agent SDK 把 Claude Code 的 Agent 循环嵌入你自己的程序——安装、最小异步示例、通过 MCP 接自定义工具、用工具限制和 hooks 控制循环、并行 subagent 扇出式多 Agent 协作 + hooks 驱动的审计轨迹，外加 Agent 循环失控的六种反模式与一套评估迭代方法。
- MCP 服务器
MCP 传输层全解：stdio vs Streamable HTTP，哪种该用、怎么选（2026）
MCP 2026 实战讲解两种传输层（stdio 本地子进程 vs Streamable HTTP 远端）——JSON-RPC 帧、握手、OAuth 2.1、session 状态、可调试性与选型决策表，外加传输层事故现场五种坑与 2026-07-28 规范变更（无状态化、Mcp-Session-Id 移除）的完整影响。
- 技能与命令
Claude Code 自托管环境实战：把云端会话跑到你自己的机器上（2026）
2026 年 Claude Code 自托管环境实战——Environment/Runner/Session 概念模型、出站-only 安全边界、从零到第一个会话的完整命令、Kubernetes 与 Compose 生产部署与排水控制，以及模型流量为何不能改走 Bedrock 或 LLM 网关。
- 提示词库
Claude 提示词工程：八大核心模式、常见坑与三条实战 prompt（2026）
一份在真实 Claude 项目中经得起检验的提示词模式实战笔记——角色设定、few-shot、思维链、ReAct、自洽性、XML 结构化、分层系统提示、自我批判——外加单轮与多轮场景的常见反模式、三条带完整注释的生产级 prompt，以及一套可落地的评估流水线框架。
- MCP 服务器
MCP 授权与 OAuth 2.1 完全指南：发现、注册与步进授权（2026）
基于 2025-11-25 版 MCP 授权规范：Protected Resource Metadata 发现链、CIMD 与动态客户端注册的新优先级、RFC 8707 resource 参数绑定、audience 校验与 step-up 授权，外加症状导向的 OAuth 排错与三个端到端集成案例。2026 年 9 月更新。
- 技能与命令
Claude Code 完全指南：从首次安装到日常工作流（2026）
Claude Code 2026 实战教程——安装 CLI、/init 项目初始化、CLAUDE.md 记忆策略、四种权限模式（default/acceptEdits/plan/bypassPermissions）、MCP server 集成、6 个最常用命令、CI/Docker 生产部署，外加上下文管理常见坑与三个完整任务实战。
- 插件与代理
Claude Code 对比 Cursor / Aider / Cline / Continue：一份实用评测
在真正重要的维度上——住在哪里、自主程度、模型选择、是否开源、MCP 支持——客观比较五款 AI 编程工具，不宣布一个普适的赢家。包含场景 → 工具决策矩阵与三条实测迁移路径（Cursor / Cline / Aider → Claude Code），双跑切换建议。
- SDK 与工具
Claude Agent SDK 实战：从首次 query 到生产级 multi-agent 编排（2026）
Claude Agent SDK 2026 实战——把 Claude Code 同一套 agent 循环以 Python / TypeScript 库形式暴露出来。覆盖 query() 异步生成器核心 API、ClaudeAgentOptions 全部字段、MCP server 接入、hooks 与审计、asyncio.gather 多 agent 扇出编排、五条生产护栏（幂等 / 成本 / 密钥 / 确定性 / 评估），以及 3 种官方部署形态（managed-agents-observe、自托管 sandbox、worker dispatch）。
- 技能与命令
Claude Code 状态栏完全指南：stdin JSON 协议与可复用脚本模板（2026）
2026 年 Claude Code 状态栏实战——statusLine 配置、stdin JSON 全字段协议（model / context_window / cost / rate_limits）、三个可直接复用的 bash 模板、事件驱动刷新机制，以及状态栏空白的五条最快排错路径。
- 教程与指南月度更新
ClaudeMap 月度更新 · 2026 年 8 月
首期月度更新：8 月新收录 85 条资源（MongoDB、Redis、Sentry、Cloudflare、AWS、Docker 官方 MCP 服务器），16 篇指南全部上线，站点新增隐私政策/使用条款与更丰富的详情页。
- SDK 与工具
Claude Prompt Caching 全解：把 Claude API 成本砍到 1/10 的实战（2026）
Claude Prompt Caching 2026 实战——四档计费机制、cache_control 断点策略、5-min 与 1-hour TTL 取舍、与 Batch API 叠加、多模态缓存（图片 / PDF block）、五种最常见失效场景（未达门槛 / 断点改动 / TTL 过期 / 模型命名空间错位 / cache_control 错位）。
- 技能与命令
Claude Code Hooks 与 Subagents：确定性自动化与并行工作
如何在 Claude Code 生命周期事件上用 hooks（PreToolUse、PostToolUse、Stop）跑脚本，以及如何用 subagents 拉起专门的并行 agent；加上 SessionStart / SubagentStop / PreCompact 等边角事件的状态注入与审计，以及 subagent frontmatter 的精确工具限制（disallowedTools / permissionMode / maxTurns），让生产配置既稳又安全。
- SDK 与工具
Claude API 入门：第一次调用、流式响应与工具使用
Claude API 新手友好教程——获取 API key、用 Python 和 TypeScript 发出第一次 messages.create 调用、流式响应、接上工具使用，以及生产级错误处理、429 限流指数退避、prompt caching + Batch API 叠加降本 80%。
- 技能与命令
Claude Code Subagents 全攻略：并行研究、定向工具、子任务三层嵌套（2026）
Claude Code Subagents 2026 实战——五个 scope 优先级（managed / CLI flag / / 用户 / plugin）、完整 frontmatter 字段、built-in agent 选型、background vs foreground 调度、上下文隔离与 SendMessage 复用、嵌套深度与并发限制，以及 worktree + background 组合的 2026 新坑。
- MCP 服务器
在 Claude Desktop 和 Claude Code 里配置 MCP 服务器（2026）
MCP 服务器配置 2026 实战——Claude Desktop 和 Claude Code 各自的配置文件路径、三层优先级（企业 / / 用户）、stdio 与 HTTP 配置形态、filesystem / GitHub / Postgres 三个真实服务器示例、OAuth scope 漂移调试，以及 7 步排错清单。
- 技能与命令
Claude Code Skills 完全指南：SKILL.md、插件与子 agent 协同（2026）
2026 年 Claude Code 技能机制实战——SKILL.md frontmatter、渐进式披露、调试触发逻辑、打包为插件，以及一个含 hooks 与子 agent 的真实 PR 评审 walkthrough。