1. 从被学长一句话问懵到跑通第一个 Claude Code 任务Claude Code 是 Anthropic 推出的终端原生 AI 编程助手它直接跑在你的命令行里能读写项目文件、执行 Shell 命令、搜索代码库、跑测试、提交 Git。它不是一个聊天窗口而是一个 Agent——聊天窗口只能回答问题Agent 能直接操作你的项目。这篇笔记适合刚接触 Claude Code、想搞清楚 Plan、Skills、子代理和上下文管理到底怎么用的人也适合已经装好工具但每次只会“打字让它写代码”的新手。我当时的处境很典型简历上写着“熟练使用 AI 辅助编程”结果被问“Claude Code 的三种工作模式分别解决什么问题上下文快满的时候你怎么处理”直接卡壳。回去之后我花了一周用一个番茄钟项目把核心操作全跑了一遍也顺手把接入通道换成了 TaoToken 的统一 Key省得每个工具单独配一遍。下面这份笔记不聊虚的只讲操作、配置和踩过的坑你跟着做就能独立完成一次完整调用。先明确一个认知Claude Code 的启动方式很简单进入项目目录执行claude底部出现输入框就能用自然语言下指令。但真正拉开差距的是你怎么控制它的工作模式、上下文和审查机制。这三块搞明白了工具使用能力才算过关。2. 前置准备用 TaoToken 统一 Key 接入 Claude Code在讲 Plan 和子代理之前得先把通道打通。Claude Code 默认走 Anthropic 官方接口但很多新手卡在 Key 配置和环境变量上。我实测下来用 TaoToken 的统一 Key 通道接入更省事一个 Key 能覆盖模型对话、编码计划等多个入口不用来回切换。TaoToken 在这里扮演的是统一 API 通道的角色你拿到 Key 之后把它配到 Claude Code 的环境变量或 settings.json 里即可。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。注意API 地址和官网地址是两个不同的东西配置时别填错。你需要提前准备的东西不多一个 TaoToken 账号、一个 API Key、本地装好的 Node.js 环境Claude Code 依赖 npm 安装。Key 的获取在控制台的 API Keys 页面建议单独建一个项目专用的 Key方便后续排查和轮换。提示Key 只显示一次复制后立刻存到密码管理器或本地环境变量文件里别直接提交到 Git。拿到 Key 后先别急着跑复杂任务。我建议先用一个空目录做验证确认通道通了再上真实项目。这一步花五分钟能省掉后面半小时的排错时间。3. 可复制配置settings.json 骨架与环境变量Claude Code 的配置分两层一层是环境变量放 Key 和 API 地址一层是项目级的 settings.json放模型、权限、工具开关。下面这份骨架你可以直接复制把占位符换成自己的值。先配环境变量。Linux/macOS 在~/.zshrc或~/.bashrc里加Windows 用系统环境变量或 PowerShell 的$env:# TaoToken 统一通道配置 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoTokenKey改完执行source ~/.zshrc让它生效。验证是否读到echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY | head -c 8第二条只打印前 8 位确认 Key 非空又不泄露全文。然后是项目级 settings.json放在项目根目录的.claude/settings.json{ model: claude-sonnet-4-20250514, permissions: { allow: [ Read, Write, Edit, Bash(git status), Bash(git diff), Bash(npm run test) ], deny: [ Bash(rm -rf *), Bash(curl *) ] }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }这份配置做了三件事锁定模型、用 allow/deny 控制工具权限、把 API 地址写进项目环境。deny 里挡掉rm -rf和curl是保命操作新手阶段尤其重要——Agent 能执行 Shell权限边界必须自己划。如果你要长期跑编码任务或 Agent 工作流可以了解下 Coding Plan 入口它更适合高频、长会话的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。短期验证模型能力的话模型对话入口更轻量https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置写完进入项目目录执行claude如果没报认证错误说明通道通了。接下来才是真正的操作部分。4. 跑通首个任务Plan 模式 Skills 子代理完整流程4.1 三种工作模式先搞清楚Claude Code 有三种模式按ShiftTab循环切换。很多人用了半年只用默认模式这是硬伤。模式核心行为适用场景Normal默认每步操作需确认不熟悉项目时需要人工把关Auto-accept自动执行不再弹窗信任度高、批量操作时Plan只分析不修改先出方案复杂需求必须先规划再动手判断标准很简单不确定 Claude 会做什么就用 Normal确定它不会搞砸就用 Auto-accept需求复杂到你自己都没想清楚就切 Plan。4.2 Plan 模式先出方案再动手大部分人一上来就让 Claude 写代码结果写出来和预期不符改来改去。正确流程是切到 Plan 模式给结构化提示词请帮我开发一个番茄钟 Web 应用技术栈用 React TypeScript Tailwind CSS。 功能包括25 分钟倒计时、开始/暂停/重置、番茄计数、休息提醒。 请先帮我规划项目结构和开发步骤不要写代码。这段提示词有三个硬性要求技术栈锁死、功能边界明确、行为约束只规划不写代码。Claude 输出方案后会给你三个选项自动执行 / 逐步确认 / 修改方案。计划会写入一个.md文档可以用CtrlG编辑。提示词质量直接决定产出质量模糊的提示词产出模糊的代码这是等式关系。4.3 Skills给 Agent 挂载专业能力功能能跑但页面丑不是模型能力问题是缺少设计领域的上下文。Skills 就是预置的能力扩展包/plugin install frontend-design安装后在提示词里指定使用番茄钟功能都完成了但页面很丑。请用 frontend-design skill 帮我重新设计界面。 我想要简洁现代的风格暖色调圆形倒计时显示配合番茄的红色主题。Skills 的本质是在主对话中注入领域知识Claude 还是同一个实例但它“读过了”一份专业设计规范。注意Skills 内容会占用主会话上下文空间这一点后面和子代理对比时很关键。4.4 子代理独立上下文的 Code Review让 Claude 审查自己写的代码存在确认偏误它倾向于认为自己的代码是对的。子代理启动一个拥有独立上下文窗口的新实例从零开始审查。通过/agents命令创建选择作用域推荐 Project用自然语言描述职责和审查标准配置可用工具和权限。使用方式用 code-quality-reviewer agents 帮我审核这个项目的代码子代理审查完只把精炼摘要返回主对话对主会话上下文占用很小。这里有个架构级区别要记住维度Skills子代理执行实例主 Claude 本体独立的新 Claude 实例上下文隔离不隔离占用主会话空间完全隔离独立窗口来源插件市场安装通过 /agents 自定义创建适用场景增强特定领域能力需要独立视角的任务Skills 是往主对话注入知识子代理是开辟新推理空间。主会话上下文紧张时子代理比 Skills 更优因为它不加重主对话负担。4.5 上下文管理/compact 与 /clearClaude 开始犯迷糊改错文件、混淆语法、遗忘约定时不是模型退化是上下文窗口快溢出了。用/context诊断占用比例超过 70% 就要干预。后续任务与当前相关用/compact把对话历史压缩为摘要切换到无关任务用/clear彻底清空。/compact不是无损压缩会丢部分细节但核心技术决策和文件修改记录会保留。关闭终端后对话自动存档恢复用claude --resume # 从列表选择历史会话 claude --continue # 直接恢复最近一次简写 claude -c5. 本篇常见报错排查配置和调用过程中新手最容易撞上这几类报错我按出现频率排一下。认证失败401 或 invalid api key。先确认环境变量是否真的生效执行echo $ANTHROPIC_API_KEY | head -c 8看有没有值。如果为空说明 shell 配置文件没 source或者写错了文件zsh 用户写进.bashrc是无效的。再检查 Key 有没有多余空格复制时很容易带上换行。连接超时或 base url 报错。检查ANTHROPIC_BASE_URL是否填成了官网地址。API 地址是https://taotoken.net/api不带 UTM 参数别把官网链接整个粘进去。地址末尾不要多加斜杠有些客户端对尾斜杠敏感。权限被拒permission denied。这是 settings.json 的 allow 列表没放行对应工具。比如你想让它跑npm run test但 allow 里只写了Bash(git status)就会被拦。按报错提示把具体命令加进 allow别图省事写Bash(*)那等于放弃权限边界。上下文溢出context length exceeded。说明单次会话塞太多了。先/compact压缩如果还不行就/clear重开靠 CLAUDE.md 兜底项目背景。CLAUDE.md 放在项目根目录启动时自动读取用/init可以自动生成。写它的原则是每条信息都问自己“删掉这条 Claude 会不会犯错”不会就不写。子代理不生效。确认/agents创建时作用域选的是 Project且调用时名字拼写一致。子代理的审查标准描述太模糊也会导致它“走过场”把审查维度写具体比如“检查是否有未处理的 Promise rejection、是否有硬编码密钥”。6. 把工具用明白才是 AI 工程化的底座回到开头那次模拟面试学长的话不好听但说的是事实工具使用能力是 AI 工程化能力的底座。面试官不会满足于“我用过 Claude Code”他会追问你怎么管理上下文窗口、Plan 模式和直接编码的区别、子代理和 Skills 的架构差异。这些答案不在文档里在你实际操作的手感里。我的建议是新建一个空项目把 Plan、Skills、子代理、/compact、/clear、引用、CLAUDE.md 这几样从头到尾跑一遍。读十遍不如动手一次。接入通道用 TaoToken 统一 Key 配好之后重点就全在操作细节上了。需要长期跑编码任务的话Coding Plan 入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先验证模型对话效果走这个https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置过程中卡住了先翻接入文档的排错章节比到处问人快。