面向中文开发者的 AI 编程实战指南：Codex、Claude Code、MCP、Skills 与 Agent 自动化，从第一次真实任务到有检查点的流水线。https://aiguide.zenty.top/zh-cnhttps://aiguide.zenty.top/articles/codex-install-login/https://aiguide.zenty.top/articles/codex-install-login/从官方安装脚本或 npm 两条路径装上 Codex CLI，分清 ChatGPT 登录与 API Key 的计费边界，再用一条只读任务同时验证可执行文件、凭据和工作目录。Sat, 14 Nov 2026 00:00:00 GMTcodexCodexCLI安装登录认证https://aiguide.zenty.top/articles/codex-windows-setup/https://aiguide.zenty.top/articles/codex-windows-setup/在原生 Windows 上确认 Codex 命令来源、选对项目目录，分清 PowerShell 与 WSL 的路径和凭据，再用一条只读任务验证环境；不假设 Windows 必须依赖 WSL。Sat, 14 Nov 2026 00:00:00 GMTcodexCodexWindowsPowerShellWSL环境配置https://aiguide.zenty.top/articles/codex-permissions/https://aiguide.zenty.top/articles/codex-permissions/把 Codex 的沙箱边界和审批策略分开理解，用只读与工作区写入两组任务观察拒绝行为，并学会从路径、网络和保护目录三个方向诊断权限失败。Sat, 14 Nov 2026 00:00:00 GMTcodexCodex权限沙箱审批安全https://aiguide.zenty.top/articles/codex-first-task/https://aiguide.zenty.top/articles/codex-first-task/用一个能跑测试的最小仓库走完 Codex CLI 完整链路：只读理解、下达约束、审阅 diff、跑 node --test 验收，并给出卡住时的排查顺序。Sat, 14 Nov 2026 00:00:00 GMTcodexCodexCLI工作流代码审阅https://aiguide.zenty.top/articles/codex-debugging-tests/https://aiguide.zenty.top/articles/codex-debugging-tests/用一个 Node 内置测试的小例子，把失败测试当作验收合同：先独立复现，再让 Codex 只改实现，最后用回归结果和 diff 审查确认没有偷改测试。Sat, 14 Nov 2026 00:00:00 GMTcodexCodex测试调试Node.js代码审查https://aiguide.zenty.top/articles/codex-project-context/https://aiguide.zenty.top/articles/codex-project-context/Codex 每次运行只读一次指令链。讲清全局与项目 AGENTS.md 的发现顺序、config.toml 的信任边界，以及如何把上下文控制在真正有用的几百字里。Sat, 14 Nov 2026 00:00:00 GMTcodexCodexAGENTS.md上下文工程配置https://aiguide.zenty.top/articles/codex-noninteractive/https://aiguide.zenty.top/articles/codex-noninteractive/用 codex exec 把 Codex 放进脚本：区分 stdout 最终消息与 stderr 进度，使用 -o、--json 和 --output-schema，并对结构化结果做独立校验。Sat, 14 Nov 2026 00:00:00 GMTcodexCodex自动化CLIJSONCIhttps://aiguide.zenty.top/articles/codex-worktrees/https://aiguide.zenty.top/articles/codex-worktrees/从同一个已提交基线创建两个工作树，让 Codex 在独立分支上改代码；合并前验证、移除前保留改动，并看清工作树共享仓库历史而不是安全沙箱。Sat, 14 Nov 2026 00:00:00 GMTcodexCodexGitworktree并行开发分支https://aiguide.zenty.top/articles/claude-code-install/https://aiguide.zenty.top/articles/claude-code-install/对照官方系统要求选择原生安装方式，用 claude --version 和 claude doctor 验证可执行文件，区分订阅与 API 认证，最后在一个练习仓库完成只读首任务。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code安装登录CLI环境配置https://aiguide.zenty.top/articles/claude-code-memory/https://aiguide.zenty.top/articles/claude-code-memory/用项目级 CLAUDE.md 和带 paths 的 .claude/rules 规则组织长期指导，检查实际加载了哪些文件，并分清“上下文建议”和“硬权限”的边界。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude CodeCLAUDE.md上下文规则项目配置https://aiguide.zenty.top/articles/claude-code-workflow/https://aiguide.zenty.top/articles/claude-code-workflow/把 Claude Code 用成稳定工具而不是抽奖：先用 /init 建立项目记忆，用 plan 模式先看方案，按权限模式逐级放权，最后用 diff 和自己的一条验证命令收尾。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code工作流权限模式CLAUDE.mdhttps://aiguide.zenty.top/articles/claude-code-permissions/https://aiguide.zenty.top/articles/claude-code-permissions/分清权限模式、allow/ask/deny 规则和工具可用性，理解 deny 先于 ask 先于 allow 的匹配顺序，并用项目设置和只读验证排查“为什么被拒绝”。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code权限安全设置工具https://aiguide.zenty.top/articles/claude-code-mcp/https://aiguide.zenty.top/articles/claude-code-mcp/复用自己构建的 wordcount MCP 服务器，选择 local、project 或 user 作用域接入 Claude Code，用 /mcp 检查连接和工具，并守住环境变量与凭据边界。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude CodeMCPstdio工具集成配置https://aiguide.zenty.top/articles/claude-code-review/https://aiguide.zenty.top/articles/claude-code-review/用 /review、/security-review 和无头模式把评审做成一道独立工序：限定输入范围、要求可定位的问题、用 hook 拦住危险动作，最后人工裁决。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code代码评审HooksCIhttps://aiguide.zenty.top/articles/claude-code-subagents/https://aiguide.zenty.top/articles/claude-code-subagents/在 .claude/agents 中定义一个只拥有 Read、Grep、Glob 的评审员，把 diff 作为输入，要求带文件行号的证据输出，并看清共享工作树不是安全隔离。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code子代理代码评审权限Agenthttps://aiguide.zenty.top/articles/claude-code-troubleshooting/https://aiguide.zenty.top/articles/claude-code-troubleshooting/按“症状—只读检查—最小修复—验证”的顺序处理命令找不到、登录失败、记忆未加载、权限被拒和 MCP 连接失败，不打印密钥，也不删除用户状态。Sat, 14 Nov 2026 00:00:00 GMTclaude-codeClaude Code故障排查诊断MCP权限https://aiguide.zenty.top/articles/mcp-concepts/https://aiguide.zenty.top/articles/mcp-concepts/用一次 count_words 调用串起 MCP 的 host、client、server、三类原语与 stdio/远程传输，建立排错前的概念地图。Sat, 14 Nov 2026 00:00:00 GMTmcpMCP架构协议https://aiguide.zenty.top/articles/mcp-boundaries/https://aiguide.zenty.top/articles/mcp-boundaries/MCP 把外部能力接进 Agent，也把外部风险接进来。逐个划清四道边界：进程权限、返回数据、凭据作用域、传输通道，并给出可落地的收紧配置。Sat, 14 Nov 2026 00:00:00 GMTmcpMCP安全权限prompt injectionhttps://aiguide.zenty.top/articles/mcp-first-server/https://aiguide.zenty.top/articles/mcp-first-server/用当前官方 SDK 写一个只做一件事的 MCP server，用 Inspector 验证协议层，再分别注册到 Claude Code 和 Codex，最后确认工具真的被调用而不是只在列表里出现。Sat, 14 Nov 2026 00:00:00 GMTmcpMCPNode.jsstdioSDKhttps://aiguide.zenty.top/articles/mcp-tool-design/https://aiguide.zenty.top/articles/mcp-tool-design/以现有 count_words 为例，设计窄名称、输入输出 schema、校验与授权边界，并把业务失败变成稳定的结构化结果。Sat, 14 Nov 2026 00:00:00 GMTmcpMCP工具设计Schemahttps://aiguide.zenty.top/articles/mcp-debugging/https://aiguide.zenty.top/articles/mcp-debugging/用 Inspector CLI 把 MCP 故障拆成进程、握手、tools/list、tools/call 四层，覆盖 stdout 污染、cwd、环境变量与 schema 问题。Sat, 14 Nov 2026 00:00:00 GMTmcpMCPInspector调试https://aiguide.zenty.top/articles/skills-first-skill/https://aiguide.zenty.top/articles/skills-first-skill/从目录、frontmatter 到完整 SKILL.md，一步步创建 change-summary，并用 Claude Code 的发现路径做手工验收。Sat, 14 Nov 2026 00:00:00 GMTskillsAgent SkillsSKILL.mdClaude Codehttps://aiguide.zenty.top/articles/skills-design/https://aiguide.zenty.top/articles/skills-design/Skill 不是提示词收藏夹。讲清它和项目规则、MCP 工具、斜杠命令的分工，怎么写可被正确触发的 description，以及为什么同一个 Skill 在不同工具里表现并不一致。Sat, 14 Nov 2026 00:00:00 GMTskillsSkillsSKILL.md上下文工程可移植性https://aiguide.zenty.top/articles/skills-resources/https://aiguide.zenty.top/articles/skills-resources/把 change-summary 拆成 SKILL.md、references、assets 和离线脚本，理解渐进加载、路径与工作目录，并跑通自测。Sat, 14 Nov 2026 00:00:00 GMTskillsAgent Skills渐进加载Node.jshttps://aiguide.zenty.top/articles/skills-validation/https://aiguide.zenty.top/articles/skills-validation/Skill 的失败大多不是内容错，而是格式不合规范、触发条件太宽或太窄、跨客户端行为不一致。用格式校验、触发矩阵、内容演练三道闸门把它们提前暴露。Sat, 14 Nov 2026 00:00:00 GMTskillsSkills校验触发测试质量https://aiguide.zenty.top/articles/skills-team-workflow/https://aiguide.zenty.top/articles/skills-team-workflow/把团队 Skill 纳入版本控制，审查改动范围、记录不可变 revision、维护兼容矩阵，并用 revert 安全回滚。Sat, 14 Nov 2026 00:00:00 GMTskillsAgent Skills团队协作版本控制https://aiguide.zenty.top/articles/agent-vs-workflow/https://aiguide.zenty.top/articles/agent-vs-workflow/以 release note 分流为例，比较确定性工作流与模型驱动工具循环的边界、成本和可观测性，给出可落地的混合方案。Sat, 14 Nov 2026 00:00:00 GMTagentAI Agent工作流发布工程https://aiguide.zenty.top/articles/agent-tool-contracts/https://aiguide.zenty.top/articles/agent-tool-contracts/用一个可离线运行的工单查询工具，拆开输入校验、独立授权、结构化业务错误和输出契约，并跑通九条断言。Sat, 14 Nov 2026 00:00:00 GMTagentAI Agent工具调用JSON Schemahttps://aiguide.zenty.top/articles/agent-tool-loop/https://aiguide.zenty.top/articles/agent-tool-loop/Agent 的本质是“调工具—读结果—再决策”的循环。真正决定它能不能上线的不是模型多聪明，而是重复调用、无进展、超时和成本这四类失败有没有被硬性限制。Sat, 14 Nov 2026 00:00:00 GMTagentAgent工具调用失败预算可靠性https://aiguide.zenty.top/articles/agent-tracing/https://aiguide.zenty.top/articles/agent-tracing/用一个离线 Node 追踪器串起 trace/run/step、重试关联、耗时与结果，在写入前脱敏，并诚实划清玩具与生产追踪的边界。Sat, 14 Nov 2026 00:00:00 GMTagentAI Agent可观测性日志脱敏https://aiguide.zenty.top/articles/agent-evaluation/https://aiguide.zenty.top/articles/agent-evaluation/给多轮 Agent 设计一套能复跑的评测：用状态检查代替话术检查，把确定性断言、模型评分和人工校准分开，并让每次失败都能定位到具体一步。Sat, 14 Nov 2026 00:00:00 GMTagentAgent评测回归指标https://aiguide.zenty.top/articles/automation-ci-checks/https://aiguide.zenty.top/articles/automation-ci-checks/为 Astro 静态站点写一条最小 CI：只读权限、固定 Node、显式工作目录，依次跑 check、build 和 smoke test，并避开 PR 密钥风险。Sat, 14 Nov 2026 00:00:00 GMTautomationGitHub ActionsCI静态站点https://aiguide.zenty.top/articles/automation-pipeline/https://aiguide.zenty.top/articles/automation-pipeline/一条能上生产的自动化流水线不是“一键全自动”，而是触发、准备、执行、复盘的串联。给出可复现的流水线骨架、失败预算、幂等要求与成本控制。Sat, 14 Nov 2026 00:00:00 GMTautomation自动化CIAgent流水线https://aiguide.zenty.top/articles/automation-secrets/https://aiguide.zenty.top/articles/automation-secrets/说清仓库/环境/组织密钥的作用域、fork PR 权限、env 注入与脱敏的局限，并用只输出布尔结果的步骤验证配置。Sat, 14 Nov 2026 00:00:00 GMTautomationGitHub Actions密钥管理供应链安全https://aiguide.zenty.top/articles/automation-idempotency/https://aiguide.zenty.top/articles/automation-idempotency/用离线 Node 示例实现幂等键、in_progress/succeeded/failed 状态、瞬时与永久错误、指数退避，并说明内存演示为何不是 exactly-once。Sat, 14 Nov 2026 00:00:00 GMTautomation幂等性WebhookNode.jshttps://aiguide.zenty.top/articles/automation-checkpoints/https://aiguide.zenty.top/articles/automation-checkpoints/全自动不是目标，可控才是。讲清检查点该放在哪些决策点、钩子为什么只能当提示层、真正的门禁为什么必须在 Agent 之外，以及“默认放行”的检查点比没有更危险。Sat, 14 Nov 2026 00:00:00 GMTautomation自动化人工审核hooks权限