第一次接触 Claude Code，不要急着让它“帮我重构整个项目”。把账号、接口、模型、权限和复杂任务一次塞进来，出错时你根本不知道是哪一步出了问题。

更稳的目标只有三个：能启动、能对话、能在练习目录里完成一次可检查的修改。

1. 建一个专门的练习目录

放两三个简单文件即可，不要使用生产仓库，也不要把 .env、私钥或客户数据复制进去。先在终端进入这个目录，再启动工具。这样即使指令写得不清楚，影响范围也有限。

2. 先问一句，再做一个小任务

第一轮只让它说明目录里有哪些文件。第二轮让它新增一个 README.md，写明项目用途。完成后自己打开文件，检查差异。这里的重点不是内容多漂亮，而是确认“读取—修改—人工验收”这条链路完整。

3. 需要兼容接口时，只替换必要配置

如果你不直接使用官方端点，通常要配置 Base URL 和 API Key。TeamoRouter 同时提供 Anthropic 原生与 OpenAI 兼容接口，一个 Key 可以切换 Claude、GPT、Gemini 等模型；官网标示部分模型低至官方标价 1 折，适合先用小额任务试跑。Claude Code 应优先使用 Anthropic 原生路径，以保留提示缓存、Thinking 和 Tool Use 等能力；实际模型价格会变化，使用前应查看实时价格。

配置完成后，仍然用刚才同一个小任务复测。一次只改一个变量：先换地址，再换模型，最后才调整高级参数。

先看懂一次请求经过了什么

配置统一接口以后，新手最容易把所有错误都归为“平台不稳定”。实际上，一次任务至少经过本地工具、协议适配、模型服务和本地命令四层。401 多半是鉴权，404 常见于地址或路径，模型不存在通常是名称映射，工具执行失败则可能发生在本机。

前面提到的统一入口在这里不仅是“换一个地址”，还可以帮助你把模型调用集中到同一处观察。但页面显示请求成功，只能证明模型层返回；最终有没有正确写入文件，仍要回到本地 diff 和测试结果判断。

4. 第一次真正的代码任务

可以让它给一个小函数补边界检查，并要求：

1. 先解释准备改哪些文件；
2. 只修改指定目录；
3. 修改后运行现有测试；
4. 最后列出差异和仍未解决的问题。

如果测试失败，不要立刻重复执行同一句话。先看错误是命令不存在、依赖缺失、接口断流，还是代码本身有问题。

5. 养成三个习惯

• 任何写入操作都先看计划；
• 任何“已完成”都以文件差异和测试输出为准；
• 密钥放在环境变量或密钥管理工具里，不写进仓库。

做到这里，才算真正完成第一次使用。后续无论增加 MCP、Skill 还是更复杂的 Agent，都可以沿用“最小任务—观察结果—逐步扩大”的方法。

出错时只问三个问题

错误发生在启动前、模型返回时，还是本地执行命令时？当前读取的地址、Key 和模型分别来自哪个配置文件或环境变量？刚才改动过什么？把这三个答案写下来，通常比一次性重装所有东西更快。第一次学习的目标不是记住全部命令，而是知道问题属于哪一层。