Claude Code MCP——给 Claude Code 接上真工具
MCP 是什么、怎么用 claude mcp add 加 server、三种 transport、以及第一天值得装的几个 server。
#Claude Code
带有该标签的文章
Claude Code hook 莫名其妙拦下 Edit
PreToolUse hook 不停地拒掉 Edit、连安全的修改也拦。多半是 exit code 逻辑、stdin 解析、或者 matcher 范围出了问题。
Claude Code MCP 调用反复超时
Claude Code 里的 MCP 工具调用（filesystem、GitHub、自定义）反复超时，可是直接 curl server 又能通。多半是 transport、stdio 帧、或者响应形态有问题。
Claude Code 输出被上下文截断
agent 长回复半句话被切掉，是上下文压力惹的祸。多半是 compaction、max_tokens 上限、或者某次工具输出把预算吃光了。
Claude Code settings.json 改了不生效
改了 ~/.claude/settings.json 或项目 .claude/settings.json，重启后 Claude Code 完全无视 hook、permissions、env。多半是 JSON 语法、scope 选错、或者优先级被覆盖。
Claude Code Skill 没被发现或不会自动触发
你在 ~/.claude/skills/ 下加了 Skill，/<name> 却说找不到，或者一直不自动触发。多半是 SKILL.md frontmatter、路径或 description 写得不够具体。
Claude Code subagent 结果回传不到主会话
Task/Agent subagent 跑完了，但主会话什么都没收到、或者总结对不上。多半是 final message 格式、上下文窗口、或者线程路由出了问题。
Claude Code Bash 沙箱阻止预期命令 —— 排查与修复
Claude Code 拒绝运行你已加白名单的命令,Bash 沙箱判定它不安全或未授权。从权限作用域、模式匹配、settings.json 配置三方面定位。
Claude Code 项目 CLAUDE.md 未加载到上下文 —— 排查与修复
Claude Code 启动后忽略你的项目 CLAUDE.md：规范、命令、说明都没到模型那里。从路径、作用域、合并优先级三方面定位问题。
Claude Code 会话恢复后丢失先前工作记忆 —— 排查与修复
恢复 Claude Code 会话却像全新开始 —— 计划没了、决定没了、未完成的重构也没了。从快照范围、压缩、记忆分层定位问题。
Claude Code 自定义状态栏脚本报错或卡顿 —— 排查与修复
Claude Code 状态栏报错、空白或让整个提示卡顿 —— 自定义脚本在静默失败。从退出码、输出格式、超时限制三方面定位。
Claude Code 权限提示陷入循环
明明给过 allow，每次 Bash、Edit、Read 都还在问——settings.json 范围错了、allowlist pattern 写得太窄，或者有 hook 在重复问。
Claude Code 任务 token 预算过大
单个任务烧 200K+ token、执行到一半撞上下文顶、被迫摘要——拆任务、用 sub-agent、收紧读取范围。
Claude Code 工具执行卡死无超时
Bash 命令永远跑、agent 永远等——没设超时一个挂死的进程就锁住整个 session。设超时、识别 hang、干净地 kill。
Claude Code 全部快捷键详解：从输入编辑到模式切换
Claude Code 所有键盘快捷键的完整参考：会话控制、模式切换、输入编辑、历史记录、IDE 集成与终端兼容性问题。
Claude Code Skills 全指南：内置、自定义、插件、团队共享
Claude Code skills 的完整入门：什么是 skill、如何调用、如何写一个 SKILL.md、何时用 hook 或 subagent 替代、以及如何在团队里共享。
Claude Code 全部斜杠命令详解：从 /usage、/clear 到 /agents
Claude Code 所有内置斜杠命令的完整指南：会话生命周期、用量成本、配置、subagent / hook / MCP 扩展、诊断与 IDE / git 集成命令。
Claude Code 误把密钥 commit 进 git：6 个来源 + 「先 rotate 后清史」处置
`.env` 或 API key 被 `git add .` 卷进 commit——先 rotate（永远），再清 git 史，最后预防：禁广 `git add` + 装 secret scanner + 收紧 gitignore。
Claude Code 写了一堆没人用的 helper：6 个 over-engineering 触发 + YAGNI 强制
你要一个函数，PR 多送 5 个「以后可能用」的——在 prompt + CLAUDE.md 限 scope，review 时狠手删。
Claude Code 跳过 / 削弱失败的测试：6 种作弊形态 + 「禁改测试」防御
Agent 加 `.skip`、删断言、放宽 matcher 让测试绿——bug fix prompt 里禁改测试、diff 时扫 skip 标记、测试改动单独 PR 写理由。
多 Agent 交接 Prompt：Claude Code 子代理模板
在 Claude Code subagent 之间交接工作的 12 个 Prompt 模板——研究 → 计划 → 实现 → 审查 → 发布，不丢上下文。
架构审查 Prompt：分层与依赖审计模板
架构审查 Prompt——分层违规、依赖环、边界泄漏、数据流、跨服务边界，每个维度独立模板，要求 file:line 证据。
全项目审查 Prompt：15 个让 Claude Code 帮你扫整个仓库的模板
全仓库审查 Prompt——架构 / 安全 / 测试覆盖 / 依赖漂移 / 性能热点 / 文档，每个维度独立模板，附 file:line 证据要求。
AI Agent 做代码审查的工作流
在 PR 发给同事之前，用 Claude Code / Codex / Cursor Agent 先做一遍 review。
Claude Code 新手指南：安装、第一次重构、常见误区
Claude Code 是什么、怎么装、怎么完成第一次重构：安装步骤、Prompt 模板和新手最容易踩的坑。
Claude Code 入门
Claude Code 是命令行 agent——它做什么、为什么开发者爱用。
Claude Code 的项目 prompt 怎么写
CLAUDE.md 不只是 readme，它是 agent 的记忆。
用 Claude Code 跑一次完整 SEO 审计
可复用的 Claude Code Prompt + 工作流，给你的内容站跑真实 SEO 审计。
Claude Code 项目配置——从空仓库到第一次有用运行
把 Claude Code 接上真实项目，30 分钟内进入有产出的状态。
Claude Code 工作流——可复用模式
Claude Code 的日常开发工作流：读代码、拆任务、改文件、跑测试、复盘上下文，整理成可重复使用的模式。
Claude GitHub 集成——真用起来的工作流
把 Claude 接上 GitHub 仓库，当成"对自己代码的研究工具"。
Claude Code 执行 Prompt：规划、实现、验证
12 个 Prompt 让 Claude Code（或 Codex）真正完成工程任务——范围明确的特性、外科手术式修复、迁移、重构、TDD、性能、调试、代码审查。
Agent 回滚不彻底：6 个域 + 按域回滚 checklist
代码回了，但 agent 漏了：过期 `dist/`、已应用的 migration、未关的 feature flag、第三方 dashboard 的改动——按域回滚，不要靠 `git reset`。
Claude Code 反复问不必要的问题：6 个噪音原因 + Defaults 设计
你要执行，agent 每 30 秒停下来问「用 TypeScript 还是 JS」——在 CLAUDE.md 写默认值 + 「只在破坏性操作前问」规则。
Claude Code 中途丢了项目上下文：6 个 summarization 触发 + 重启 vs 加固
Agent 突然忘了之前定的事、反复读 CLAUDE.md、和 plan 矛盾——自动摘要把承重细节压没了。重新锚定或者干脆 restart。
Claude Code 不照审计报告做：6 个降为「建议」的原因 + 把报告当合同
你给了详细 audit report，Claude Code 我行我素——它把报告当 context 不当 contract。转成编号 checklist、一次一条执行、终点 diff 对账。
Claude Code 误解你的项目架构：6 个 generic prior 取胜 + 用「我们用 / 我们不用」清单 + canonical 锁死
Agent 建议「拆成微服务」但你刻意单体——在 CLAUDE.md 写「we use / we don't use」+ 真文件 canonical example，让具体战胜泛型先验。
Claude Code 输出和 prompt 不符：6 个 plan 阶段误读 + restate-before-execute
Diff 是漂亮代码但解决了**别的**问题——misalignment 几乎总是 plan 阶段，不是 code 阶段。强制让它先 restate task 再动手。
Claude Code 覆盖了你未提交的改动：6 个触发原因 + 编辑器 local history 抢救
未提交的活儿被 agent 跑没了——先用编辑器 local history 抢救，再用「跑 agent 前先 commit」 + worktree 防止再发生。
Claude Code Plan 模式偏离计划：6 个 scope creep 来源 + 把 plan 当合同
你批准 5 步 plan，Claude 做了 7 步、跳了 1 步、顺手 refactor 旁边代码——把 plan 当 numbered checklist + 每步停下来汇报。
Claude Code 不理解你的项目怎么办：让 agent 真正读懂代码的 7 个方法
Claude Code 改了一半文件、问的问题对不上、找不到关键函数？多半不是模型不行，而是它没拿到正确的项目上下文。本文给出 7 个方法让 agent 一次就读懂你的项目。
Claude Code 重构 scope 越做越大：6 个 creep 来源 + 「可编辑文件清单 + FOLLOWUPS.md」
你要小改，PR 一来 5 个文件、200 行——在 prompt 里固定可编辑文件清单，相邻问题写到 FOLLOWUPS.md，不要顺手改。
Claude Code 因额度耗尽中途停下：6 类 limit + 可恢复任务设计
重构做一半 Claude Code 提示额度用完——分清是 5 小时 / 周 / 单模型哪种 limit，立刻 dump 状态，按对应路径恢复。
Claude Code 部分执行后卡死：6 种卡死形态 + 分清「上下文 / 工具挂 / 静默 abort」
做完 60% 不报错也没完成消息——三种形态：context 满、工具挂、静默 abort，每种的诊断和恢复路径不同。
Claude Code 卡在循环里：6 种 loop 签名 + 各自的一句话破解
Agent 反复同样 edit、来回切换两个文件、永远追 flaky 测试——6 种 loop 签名各有诊断和 one-prompt 破法。
Claude Code 改错文件：6 种命名混淆 + 用 allow + deny 清单防御
改了你没让改的文件——同名 / 大小写差 / import 链外扩——git revert + 在 prompt 里加 allow / deny 清单消歧。
多 Agent 冲突：两个 agent 改了同一份文件——6 个 overlap 来源 + worktree 隔离
Claude Code + Codex（或两并行 session）改同一函数产冲突——用 worktree 隔离 scope，绝不让 agent 自己 resolve merge。
Claude Code vs Cursor：什么任务用哪个
Claude Code 是命令行 agent，Cursor 是编辑器内副驾驶。任务类型、调试链路、回滚成本不同——这篇给一张选择表。
用 Claude Code 搭内容站
2026 年用 Claude Code 从零开始搭一个 Astro 内容站的真实流程：哪些可以交给 AI、哪些必须自己来、以及它会在哪些地方翻车。
建站用的 AI Prompt 怎么设计：范围控制、schema 锚定、避免漂移
用 CLAUDE.md 模板、三段式 prompt、每任务约束清单，让 Agent 在跨 session 的多文件建站里不跑偏。
Claude Code 是什么？Anthropic 官方终端 AI 详解
Claude Code 是 Anthropic 出的命令行 AI 工具。本文讲清它能做什么、跟 ChatGPT / Cursor 有啥不同，以及前 10 分钟怎么上手。