给愿意碰命令行、能自己查文档的人：AI 编程工具配置与 agent 工程细节，具体到字段名、命令、报错原文和验证方法。https://ai-atlas.pages.dev/zh-cnhttps://ai-atlas.pages.dev/about/https://ai-atlas.pages.dev/about/关于 AI 技术图谱的作者、内容生产方式、反馈入口和催更渠道。Thu, 20 Aug 2026 09:35:09 GMThttps://ai-atlas.pages.dev/agents/https://ai-atlas.pages.dev/agents/上下文工程、skills、subagent、循环任务、自动压缩这类 agent 工程细节。Thu, 20 Aug 2026 09:35:09 GMTpart-introhttps://ai-atlas.pages.dev/agents/auto-compact-window/https://ai-atlas.pages.dev/agents/auto-compact-window/设置 CLAUDE_CODE_AUTO_COMPACT_WINDOW 或 autoCompactWindow 调整 Claude Code 的自动压缩阈值，再用故意调低阈值观察触发的方法确认配置生效。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/agents/claude-md-context/https://ai-atlas.pages.dev/agents/claude-md-context/CLAUDE.md 是从文件系统根往工作目录方向逐层拼接的，越靠近你启动位置的指令被读得越晚。@import 只帮组织不省上下文，因为导入的文件在启动时一样全部加载。真正能省上下文的是 .claude/rules/ 的 paths 条件加载和 skills。Thu, 20 Aug 2026 09:35:09 GMTconcept进阶https://ai-atlas.pages.dev/agents/goal-command/https://ai-atlas.pages.dev/agents/goal-command//goal <条件> 设定后立即开始跑，每轮结束用一个独立小模型（默认 Haiku）评估一次 yes/no；不满足就继续下一轮，官方没有设默认的轮数或时长上限——这是它能被"随手挂着跑一两天"的根本原因，也是和 /loop 最大的区别。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/agents/long-running-tasks/https://ai-atlas.pages.dev/agents/long-running-tasks//loop 有 7 天过期且按固定间隔等待；/goal 没有默认的轮数或时长上限，条件不满足就直接开始下一轮，这是它能被随手挂着跑一两天的原因；真正要脱离本机、或按固定时刻/外部事件触发的，才用 Routines 或 Desktop scheduled tasks。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/agents/loop-agent/https://ai-atlas.pages.dev/agents/loop-agent//loop 是内置技能，最简单的写法是 /loop <间隔> <提示词>；任务绑定在当前会话，7 天后自动过期，官方文档里没有 /proactive 这个别名。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/agents/skills/https://ai-atlas.pages.dev/agents/skills/skill 的正文只在被调用时加载，所以长参考资料在用到之前几乎不花钱。但一旦加载，内容会留在上下文里直到会话结束，Claude Code 不会在后续轮次重读文件。disable-model-invocation 和 user-invocable 控制的是两个不同方向的调用权。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/agents/subagents/https://ai-atlas.pages.dev/agents/subagents/subagent 的价值是上下文隔离：冗长输出留在它自己的窗口里，只有摘要回到主对话。但隔离是双向的，它看不到你的对话历史。fork 是例外，它继承整个对话并共享 prompt 缓存，所以比新起 subagent 更便宜。Thu, 20 Aug 2026 09:35:09 GMThands-on硬核https://ai-atlas.pages.dev/claude-code/https://ai-atlas.pages.dev/claude-code/配置文件分工、hooks、权限模式、MCP、成本控制、CI 集成，以及区域限制报错的定位思路。Thu, 20 Aug 2026 09:35:09 GMTpart-introhttps://ai-atlas.pages.dev/claude-code/costs-and-usage/https://ai-atlas.pages.dev/claude-code/costs-and-usage/挂了一整天的会话里问一句话，代价是整个会话历史。/usage 的美元数字是本地按标准价算的，订阅用户不用看它。真正省钱的手段按收益排序是：不相关任务间 /clear、模型选型、把冗长输出交给 subagent、用 hook 预过滤。Thu, 20 Aug 2026 09:35:09 GMTconcept进阶https://ai-atlas.pages.dev/claude-code/deepseek-backend/https://ai-atlas.pages.dev/claude-code/deepseek-backend/设置 ANTHROPIC_BASE_URL 指向 DeepSeek 的 Anthropic 兼容端点、ANTHROPIC_API_KEY 放密钥，写进 settings.json 的 env 字段比 export 持久；地域限制报错是官方 Anthropic API 的合规检测，走第三方兼容端点不会经过那道检测。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/claude-code/headless-ci/https://ai-atlas.pages.dev/claude-code/headless-ci/-p 模式下 --output-format json 拿结构化结果，stream-json 拿实时事件。CI 里必须设 --max-turns 和 --max-budget-usd 双保险，因为前者拦轮数、后者拦花钱。认证用 claude setup-token 生成长期 token 或 API key，不要依赖交互式登录。Thu, 20 Aug 2026 09:35:09 GMThands-on硬核https://ai-atlas.pages.dev/claude-code/hooks/https://ai-atlas.pages.dev/claude-code/hooks/hooks 是在固定生命周期事件上执行的 shell 命令，属于强制执行层而非建议层。退出码 2 是「阻塞并把 stderr 回灌给模型」的专用信号，stdout 输出 JSON 可以做更精细的控制，包括注入上下文、改写权限决策、阻止会话结束。Thu, 20 Aug 2026 09:35:09 GMThands-on硬核https://ai-atlas.pages.dev/claude-code/mcp-servers/https://ai-atlas.pages.dev/claude-code/mcp-servers/MCP 的 local 和 user scope 存在 ~/.claude.json，project scope 存在项目根的 .mcp.json。project scope 的服务器首次使用需要你批准，克隆下来的仓库无法自行批准。tool search 默认开启，只加载工具名而非完整定义，所以接入更多服务器对上下文的影响很小。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/claude-code/permission-modes/https://ai-atlas.pages.dev/claude-code/permission-modes/auto mode 用一个分类器逐条判断命令风险，bypassPermissions 则完全不判断。前者是「让模型自己决策但保留硬边界」，后者是「关掉整个权限层」。auto mode 的规则可以用 autoMode 字段自定义，但只从用户层和 managed 层读取。Thu, 20 Aug 2026 09:35:09 GMTconcept进阶https://ai-atlas.pages.dev/claude-code/settings-files/https://ai-atlas.pages.dev/claude-code/settings-files/配置优先级从高到低是 managed 设置、命令行参数、.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json。标量值按优先级覆盖，数组值跨层合并去重（fallbackModel 和 availableModels 例外）。settings.json 管行为配置，.claude.json 管登录态、MCP 的 local/user scope 和项目信任记录。Thu, 20 Aug 2026 09:35:09 GMThands-on进阶https://ai-atlas.pages.dev/index/https://ai-atlas.pages.dev/index/给愿意碰命令行、能自己查文档的人：AI 编程工具配置与 agent 工程细节，具体到字段名、命令、报错原文和验证方法。Thu, 20 Aug 2026 09:35:09 GMThttps://ai-atlas.pages.dev/preface/https://ai-atlas.pages.dev/preface/这个站收集什么、写给谁、每篇怎么写，以及它和《验收先行》的关系。Thu, 20 Aug 2026 09:35:09 GMThttps://ai-atlas.pages.dev/reference/https://ai-atlas.pages.dev/reference/报错原文索引、全站待核实清单、以及各章的版本核对状态。Thu, 20 Aug 2026 09:35:09 GMTpart-introhttps://ai-atlas.pages.dev/reference/error-index/https://ai-atlas.pages.dev/reference/error-index/带着报错原文进来的话从这里查。每条给出真实原因和对应章节，以及那些「不报错但也不生效」的静默失败场景。Thu, 20 Aug 2026 09:35:09 GMThands-on新手https://ai-atlas.pages.dev/reference/unverified/https://ai-atlas.pages.dev/reference/unverified/把散落在各章末尾的待核实条目集中起来，按「文档未覆盖 / 需要实测 / 版本差异」三类归档。这一页的存在是为了让「我不确定」这件事可被检索，而不是藏在文章末尾。Thu, 20 Aug 2026 09:35:09 GMTconcept新手