1. 接手陌生代码库为什么第一句话决定后面三小时刚接手一个项目你打开 Claude Code脑子里想的是「先让它帮我看看这个 bug」。结果它读完两三个文件顺手把package.json里的依赖升了级又新建了一个你没同意的目录最后还问你要不要git commit。你花在回滚和解释上的时间比手写代码还多。问题不在模型能力在于你还没给它立规矩就让它开工了。这就像招了个新同事没给员工手册、没讲工作流程直接丢一句「去干活吧」。它只能靠猜而猜错的代价由你承担。我试过更稳妥的做法把「接手项目后的第一句话」固定成一个初始化协议。核心目标有三个——先读AGENTS.md和CLAUDE.md这类入口文件再梳理目录结构与git commit历史最后只输出一份可执行的改造计划而不是直接动手改代码。这样第一次对话的产物就是一份项目交接清单而不是一堆待回滚的 diff。这篇会给你可直接复制的 Prompt 模板、AGENTS.md片段以及一次git commit前后的验证动作。适合谁刚接手遗留项目、需要让 Claude Code 或 Codex 快速建立上下文、又不想被 AI 乱改配置的开发者。关键词先记住Claude Code、Prompt、Codex、git commit、AGENTS.md这五个词贯穿全文。先说清楚「第一句话」和普通提问的区别。普通提问是任务导向的「帮我修这个函数」。第一句话是协议导向的先建立行为边界再谈任务。边界包括——哪些文件只读、哪些可以写、什么情况下必须停下来问你、完成后要汇报什么。没有这层边界模型会默认「尽量帮你把事做完」于是自作主张就成了默认行为。2. TaoToken 前置把模型入口和 Key 先备好在写 Prompt 之前得先有一个稳定的模型调用入口。Claude Code 和 Codex 这类工具都需要 Base URL、API Key、Model ID 三件套。我这边统一走 TaoToken 的 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时别把推广参数拼进去。为什么先讲这个因为初始化协议里有一条「读取远程规范 URL读不到就停止」。如果模型入口本身不稳定第一步就会卡住后面全乱。所以顺序是先把 Key 和 Base URL 配好确认能正常对话再发初始化 Prompt。拿 Key 的路径很直接进控制台创建 API Key然后按你用的工具填配置。Claude Code 走的是 Anthropic 兼容配置Codex 走的是auth.jsonCline 这类走 MCP 或 OpenAI 兼容配置。三件套缺一不可尤其是 Model ID填错会直接报model not found。这里给一个通用的配置对照方便你按工具选工具配置文件关键字段说明Claude Code环境变量 / settingsANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、模型名走 Anthropic 兼容协议Codex~/.codex/auth.jsonbase_url、api_key、model三件套写全Cline / MCPMCP 配置 JSONbaseUrl、apiKey、model注意字段大小写如果你还没建 Key可以先到 API Keys 页面创建https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制一次页面刷新就不再显示完整 Key这点和大多数平台一样。配置完成后先用一句最简单的对话验证通路比如「回复 ok」。能正常返回再进入下一步。别跳过这步否则后面报错你分不清是 Prompt 问题还是 Key 问题。3. 可复制配置AGENTS.md 片段与初始化 Prompt 模板这一节是全文最该直接抄的部分。先给AGENTS.md片段再给第一句话 Prompt 模板最后给 Claude Code 和 Codex 的配置片段。3.1 AGENTS.md 薄入口片段AGENTS.md的设计原则是「薄入口」只做指针不复制任何环境配置或命令。因为一旦复制项目演进后入口文件就过时了AI 还在用旧信息。# AGENTS.md 本文件是 AI 工具的统一入口只做引用不承载业务信息。 请按顺序阅读以下文档后再执行任何操作 1. INIT.md —— 初始化协议与行为边界 2. DEV.md —— 开发规范与协作流程 3. README.md —— 项目说明与目录结构 4. TODO.md —— 当前任务与待确认决策 约束 - 未阅读上述文档前不得修改任何业务代码、配置文件、依赖文件。 - 不得主动执行 git commit除非用户明确要求。 - 可以执行 git status、git diff、git log 等只读检查。 - 所有不确定信息标注「待确认」并汇总到 TODO.md。CLAUDE.md可以更短直接指向AGENTS.md# CLAUDE.md 请先阅读 AGENTS.md并严格遵循其中引用的规范文档。 不要在本文件中复制环境变量、测试命令或部署流程。3.2 第一句话 Prompt 模板下面这段就是「接手项目后对 Claude Code 说的第一句话」可直接复制。注意把 URL 换成你自己的规范地址内网环境建议放仓库内相对路径。请先读取项目根目录的 AGENTS.md 与 CLAUDE.md并严格遵循其中的引用规范。 如果 AGENTS.md 不存在请读取 https://taotoken.net/api 对应的接入文档说明 若仍无法获取规范必须立即停止并说明原因不要凭空猜测。 在完成阅读前暂时不要修改任何业务代码、配置文件、依赖文件或构建产物。 只允许在当前项目根目录建立或完善以下文档 INIT.md、DEV.md、README.md、TODO.md、AGENTS.md、CLAUDE.md。 请执行以下只读检查并汇报 1. 列出当前目录结构深度不超过 3 层。 2. 执行 git log --oneline -20总结最近的提交主题与改动范围。 3. 执行 git status说明当前工作区是否干净。 4. 阅读现有 README 与 CONTRIBUTING如有指出缺失信息。 除非我明确要求「提交代码」「commit」否则不得主动执行 git commit。 如认为需要提交请先说明原因并等待我确认。 初始化完成后请输出 - 新增或修改了哪些文档 - 每个文档的主要内容 - 哪些信息仍需人工确认用「待确认」标记 - 一份可执行的改造计划按优先级排序暂不执行。这段 Prompt 在做什么拆开看读取入口文件建立上下文读不到就停止杜绝编造白名单约束只允许改 6 个文档只读检查目录和git commit历史禁止主动 commit完成后汇报并给计划。每一步都是可验证的。3.3 Claude Code 与 Codex 配置片段Claude Code 走环境变量或 settings核心三件套export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_API_Key export ANTHROPIC_MODEL你的_Model_IDCodex 的auth.json三件套写全{ base_url: https://taotoken.net/api, api_key: 你的_API_Key, model: 你的_Model_ID }Cline 走 MCP 配置时字段名注意大小写{ mcpServers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key, model: 你的_Model_ID } } }配置完先验证通路再发初始化 Prompt。顺序错了排障会翻倍。4. 验证请求一次 git commit 前后的完整动作初始化跑完后怎么确认它真的守规矩看两个动作git status和git diff。下面演示一次完整流程。第一步发完 Prompt 后模型应该先输出只读检查结果。你重点看它有没有执行git log --oneline -20有没有列出目录结构。如果它直接开始写文件说明入口文件没生效停下来检查AGENTS.md是否在根目录。第二步检查它新建的文档。正常情况只会出现INIT.md、DEV.md、README.md、TODO.md、AGENTS.md、CLAUDE.md这几个。执行git status预期输出是「Untracked files」里只有这几个文档没有package.json、go.mod、requirements.txt的改动。如果依赖文件被动了说明白名单约束没生效。第三步看TODO.md里的「待确认」清单。技术栈、目录结构、第一个迭代功能这些应该都被标出来。你补一句「技术栈用 Go Gin前端 React目录按标准脚手架」让它更新到README.md和DEV.md。第四步验证 commit 边界。故意说一句「帮我改下登录逻辑」观察它是否先记入TODO.md、是否先做只读检查、是否在改完后等你确认再 commit。正常表现是改完提示「已完成是否需要提交」而不是直接git add . git commit。第五步如果你确认要提交明确说「提交这次改动」。然后执行git log --oneline -3 git show --stat HEAD确认这次 commit 只包含你审阅过的文件没有夹带无关改动。这一步是最后一道防线别省。整个流程跑下来你会得到一份可追溯的交接清单目录结构、提交历史摘要、待确认决策、改造计划。第一次花 5 分钟后面每次对话都省下解释成本。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth初始化协议跑不通八成是配置或环境问题。下面按真实报错对照排查。401 UnauthorizedKey 无效或没带上。检查ANTHROPIC_API_KEY或auth.json里的api_key是否完整复制有没有多余空格。注意 API 地址是 https://taotoken.net/api 不要拼 UTM 参数。如果刚创建 Key确认没有在页面刷新后复制到空值。local proxy failed / connection refused本地代理或端口配置问题。检查ANTHROPIC_BASE_URL是否写成了本地地址或者系统代理拦截了请求。把 Base URL 改回 https://taotoken.net/api 再试。这类报错通常和网络层有关不是模型问题。reading choices / choices 字段读取失败多出现在 OpenAI 兼容协议的工具里说明返回结构和你用的解析方式不匹配。检查 Model ID 是否填错或者工具版本是否支持当前返回格式。换一个明确的模型名再试别用模糊别名。OAuth 相关报错Claude Code 某些版本会走 OAuth 流程如果你用的是 API Key 模式需要在配置里明确关闭 OAuth 或选择 API Key 认证。检查 settings 里是否有冲突的认证字段只保留一套。AGENTS.md 不生效确认文件在项目根目录文件名大小写一致。有些工具只认AGENTS.md不认agents.md。另外确认 Prompt 里明确写了「先读取 AGENTS.md」否则模型可能跳过。git commit 被主动执行说明 Prompt 里的禁止条款没被遵守或者你用的工具默认开启了自动提交。检查工具设置里是否有 auto-commit 选项关掉它。同时在AGENTS.md里把「不得主动 commit」写成硬约束。排障顺序建议先验证 Key 和 Base URL 通路再验证入口文件是否被读取最后验证白名单和 commit 边界。一层层来别一次改多个变量。6. 把第一句话变成长期习惯初始化协议不是一次性动作。项目演进后README.md和DEV.md需要手动更新AI 每次对话前会重新读取自动适应新规范。维护文档的成本远低于每次跟 AI 解释的成本。如果你要长期做编码和 Agent 任务可以考虑 Coding Plan把模型调用和额度管理固定下来https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。验证模型效果可以直接用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。下次接手项目把第 3 节那段 Prompt 直接发给 Claude Code观察它是不是先读AGENTS.md、先梳理git commit历史、先给计划再动手。如果它做到了你就得到了一份可执行的项目交接清单而不是一堆待回滚的改动。