Claude Code 用法：终端里的 AI 编程代理

上一课你把 Claude Code 装到了「能用」的状态；这一课 15 分钟，把它用到「顺手」：启动会话、用一句话派活、@ 引用文件、开计划模式、检查改动再提交。本篇 Claude Code 教程聚焦终端 CLI 这个主形态——它是官方文档里功能最全的形态，其他形态（IDE 插件、桌面版、网页版）共用同一套引擎，后面再统一带你过一遍。（事实核对时间 2026-11-04；命令与功能会随版本更新，以官方文档为准。）

学完你能做什么

• 在任何项目目录里启动 Claude Code，看懂提示符上方的版本、模型和工作目录
• 用一句具体的自然语言让它改代码、修 bug、写测试——它自己读文件、跑命令
• 用 @ 把指定文件「喂」进对话，用 / 快捷命令、! 直接跑 shell 命令
• 大改动先开计划模式（plan mode），审完方案再让它动手
• 用 /diff 检查改动，再让它写提交信息、创建 PR，最后会话收尾能打断、清空、续聊

你现在的困境

• 装是装好了，但打开终端不知道「说什么」：一句话敲出去，它改的方向和我想的不一样，来回拉扯
• 网上的 Claude Code 中文教程要么只讲安装，要么直接跳到 MCP、子代理这些高级货，日常那几招反而没人讲清楚
• 它改了一堆文件，我不知道改了哪里、怎么检查，不敢直接提交；会话越聊越长，感觉又慢又贵

什么时候用这一招

当你需要：

• 在终端里让 AI 直接读你的项目、改文件、跑命令、提交代码——而不是复制粘贴到网页聊天框
• 修 bug、写测试、重构、生成提交信息这些日常开发活，一句话派出去
• 改动可控：先看方案、再改代码、改完能检查、不满意能回退

而且不想：

• 每换一个任务就重开一个工具、重新解释一遍项目背景
• AI 悄悄改了文件你还蒙在鼓里
• 高级玩法（MCP、Skills、子代理）还没用上就被劝退——那些放到进阶手册再讲

🎒 开始前的准备

• 完成了上一课 安装 Claude Code：claude --version 能打出版本号，且已完成首次登录（订阅或 Console 账号二选一；装不上先去 装不上怎么办）
• 一个 Claude 订阅（Pro / Max / Ultra / Team / Enterprise）或 Console 账号——官方对多数形态的要求；各档价格见 价格对比，地区政策事实见安装课提示框
• 一个放在 git 仓库里的练手项目（本课第 5 步要提交代码；还没有项目也没关系，Claude 能帮你从零建一个）
• 15 分钟不被打扰的时间

💡 没怎么用过终端？

官方专门写了终端新手指引，开篇第一句就是「即使你从没用过终端，你也可以用 Claude Code」。终端只是「打字 → 回车 → 执行」的窗口，本课每条命令都可以直接复制粘贴。

核心思路

Claude Code 是 Anthropic 官方文档里的 agentic coding tool（代理式编程工具）：它读你的代码库、编辑文件、运行命令、接入你的开发工具——不是「你贴代码它给答案」的聊天框，而是「你派活、它干完」的代理。

和网页版 AI 聊天的根本区别：

	网页聊天 AI	Claude Code（终端）
代码进上下文	你手动复制粘贴	它自己读项目文件
改代码	给你片段，你自己粘	直接编辑文件，/diff 可查
验证	你自己跑命令	它能跑测试、看报错、自己修
提交	你自己写 commit	一句话让它写提交信息、开 PR

四种形态，一套引擎。 Claude Code 不止终端一种形态，每种形态连的是同一个底层引擎——你项目的 CLAUDE.md、设置、MCP 服务器在所有形态间通用：

形态	一句话定位
终端 CLI（本课主线）	功能最全的主形态：编辑文件、跑命令、管理整个项目
VS Code / JetBrains 插件	编辑器里用：内联 diff、@ 引用、计划审查、会话历史（JetBrains 插件需另装 CLI）
桌面应用	IDE 和终端之外的独立 App：可视化看 diff、多个会话并排、定时任务
网页版	浏览器打开 claude.ai/code，无需本地安装：跑长任务、并行多任务

日常使用的心法就一条：你说清「做什么、在哪做、做成什么样」，Claude 负责读、改、跑、验。它跑偏了你按 Esc 打断，改错了你回退，一个任务做完就 /clear 清场——这套循环就是本课六步。

跟我做

第 1 步：进入项目目录，启动 Claude Code 会话

为什么：Claude Code 在你启动它的那个目录里工作——先 cd 进项目，它读到的才是这个项目的文件。

cd /path/to/your/project
claude

你应该看到：提示符出现，上方显示版本号、当前模型和工作目录三样信息。新开的终端会话默认进 auto 模式（常规操作直接执行，有风险的动作会先经过一道安全审查，该拦的会被拦下），默认模型在多数订阅下是 Claude Opus 5.5。

立刻有用的入口：

/help

你应该看到：可用命令列表。输入 / 会弹出命令菜单，输入 / 加几个字母可以过滤。

• 小检查：提示符上方能看到版本号、模型和工作目录，/help 能列出命令

第 2 步：Claude Code 教程核心：怎么用？像派活一样说清一件事

为什么：提示词越具体，越省一轮返工。官方最佳实践给的对比例子——笼统说「修登录 bug」，Claude 只能猜；说清文件、症状、「修好」的标准，它一次就能对准目标。

❌ 笼统派活：

fix the login bug

✅ 具体派活（官方示例原文）：

users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it

日常几类活的说法（都来自官方工作流指南）：

任务	你说
修 bug	I'm seeing an error when I run npm test（把报错原样贴给它）
写测试	write tests for the auth module, run them, and fix any failures
读懂代码	give me an overview of this codebase
找代码	find the files that handle user authentication

你应该看到：Claude 自己去读文件、列出要改的地方，然后动手编辑；需要跑命令验证时它会自己跑（比如跑刚才那个失败测试，看它变绿）。

💡 想要「完整版」就明说

官方最佳实践提到一个仍然好用的短语：be ambitious。Claude 倾向于做「刚好满足要求」的最小版本——你想要边界情况也处理、保存流程也接好的完整版，在提示词里加上这句。

• 小检查：我派了一件具体的活，看到 Claude 自己读文件、改文件、跑命令

第 3 步：用 @ 把文件和目录喂进对话

为什么：等 Claude 自己找文件需要时间；@ 引用让指定文件的内容直接进入对话，它马上就能针对这个文件干活。

引用单个文件（官方示例）：

Explain the logic in @src/utils/auth.js

引用整个目录（拿到的是文件列表，不是全部内容）：

What's the structure of @src/components?

你应该看到：输入 @ 时弹出路径建议菜单，按 Tab 或 Enter 接受高亮的路径，再按 Enter 发送；发送后文件内容进入对话，Claude 的回答直接围绕这个文件展开。

两个边界要知道（官方文档原文的数字）：单个文件的内容默认最多 25,000 tokens 进入对话；超过 256KB 的文本文件不会自动带入。

• 小检查：我用 @ 引用了一个文件，Claude 的回答明确基于它的内容

第 4 步：大改动先开计划模式，审完方案再动手

为什么：有些改动你想在落盘之前先看方案。计划模式（plan mode）下 Claude 只读文件、给计划，不改任何文件——直到你批准。

两种开法，任选其一：

claude --permission-mode plan

或者会话进行中按 Shift+Tab，循环切换权限模式。

你应该看到：状态栏出现 ⏸ plan mode on。Claude 读文件、提出改动计划，等你审；你批准后它才开始编辑。

顺带记住 Shift+Tab 切到的那一排模式：Manual（每步都要你点头）→ acceptEdits（自动接受编辑）→ plan（只规划不动手）——日常用默认的 auto 模式起步，拿不准的大改动切 plan。「先规划再动手」这套纪律对所有 AI 编程工具通用，展开讲见 先规划再动手：把一句话想法变成需求清单。

• 小检查：我能在状态栏认出 ⏸ plan mode on，并知道此时 Claude 不会改文件

第 5 步：用 /diff 检查改动，再让它提交或开 PR

为什么：AI 写的代码要过目再入库。/diff 让你不离开终端就看到工作区的全部改动——包括 Claude 刚才改的和你自己没提交的。

在会话里输入：

/diff

你应该看到：改动文件列表，每个文件标着新增/删除的行数，下面是具体 diff。全屏渲染下是常驻面板（Claude 每改一次文件自动刷新），旧渲染器下是一个看完按 Esc 关闭的对话框。

检查完没问题，让它提交（官方示例）：

commit my changes with a descriptive message

要开 PR 就接着说：

create a pr

你应该看到：Claude 直接操作 git——暂存改动、写提交信息、建分支、开 PR；PR 开出来后给你链接。它和 git 是原生打通的，这几步不需要你敲一条 git 命令。

• 小检查：我用 /diff 过目了改动，并让 Claude 完成了一次提交或 PR

第 6 步：会话收尾——打断、清空、续聊

为什么：会话管理决定你「第二天还愿不愿意打开它」。四个动作覆盖最常见的收尾场景：

场景	操作	效果
Claude 跑偏了	按 Esc	立刻打断，保留已完成的工作，你重新指方向
想回退到几步之前	空输入时连按两次 Esc	打开回退菜单，把代码、对话或两者一起恢复到之前的节点
换一件不相关的任务	/clear	清空上下文重新开始——官方建议：同一件事纠正两次还不对，就 /clear 重写提示词，别来第三次
明天接着干	退出后运行 claude --continue	恢复当前目录最近的会话；claude --resume 从列表里挑

你应该看到：claude --continue 直接带着上次的对话上下文回来（当前目录还没有会话时，它会打印 No conversation found to continue 然后退出——此时用 claude 开个新会话即可）。

💡 长任务给会话起个名字

在会话里运行 /rename <名字>（官方示例用 /rename oauth-migration），之后在终端用 claude --resume <名字> 就能精准找回，回退点也在。

• 小检查：我用 Esc 打断过一次 Claude，并用 claude --continue 成功续上过一个会话

检查点 ✅

• 我能在项目目录启动 Claude Code，认出提示符上方的版本、模型、工作目录
• 我会派具体的活：说清文件、症状、「修好」的标准，而不是一句「帮我修 bug」
• 我会用 @ 引用文件、/ 调命令菜单、! 直接跑 shell 命令（如 ! npm test，输出会进对话，Claude 自动回应）
• 大改动我会在动手前开 plan mode（claude --permission-mode plan 或 Shift+Tab），看到 ⏸ plan mode on 再放心
• 改动我先用 /diff 过目再让它提交；会话我会用 Esc 打断、/clear 清场、claude --continue 续聊

踩坑提醒

❌ 一句话太笼统，来回拉扯十轮还没对准

「优化一下这个项目」「修修这个 bug」这类派活方式，Claude 只能靠猜。官方最佳实践的对照：把 "fix the login bug" 换成 「用户反馈会话超时后登录失败；去看 src/auth/ 的 token 刷新，先写一个能复现的失败测试，再修好它」——文件、症状、验收标准三样给齐，通常一轮就中。

❌ 它改了什么我不知道，直接就提交了

AI 改动不等于正确改动。正确顺序：/diff 过目 → 满意再让它提交。两个补充保险：一是用 git 管理项目——官方文档明说回退点（checkpoint）只覆盖 Claude 用文件工具改的文件，只用 Bash 命令碰过的文件不在恢复范围内，git 才是兜底；二是大改动先开 plan mode，方案审完再落盘。

❌ 一个会话里堆三件不相关的活，越聊越慢、越聊越贵

官方成本指南解释过：每次请求都带着整个对话发出去——你把三个任务的历史都塞给了第四轮。正确做法：换任务就 /clear，成本为零；长会话需要保留重点时用 /compact 加一句关注点说明（如 /compact keep the API changes and the test commands）。

❌ Claude 忙的时候干等，或者不停敲 Enter 打断它

它工作时你可以直接继续输入下一条消息——Claude Code 会把消息排进队列，等当前这轮做完按顺序处理（按 Ctrl+Enter 立刻发送队列）。要改方向才用 Esc 打断；打断不丢工作，已完成的部分都保留。

进阶技巧（可选）

给项目留一份「说明书」。 在项目根目录放一个 CLAUDE.md，写上验证命令、约定和坑——Claude Code 每次会话都会读它。会话里运行 /init 能从代码库生成初稿，/context 可以确认它加载了没有。写法详解见 AGENTS.md 与 CLAUDE.md：给 AI 留一份项目说明书。

让它自己查太慢的活，交给子代理。 探索大代码库会塞满主对话上下文，官方建议把调查类工作委托出去：

use a subagent to investigate how our auth system handles token refresh

子代理在自己的上下文窗口里读文件，只把结论带回来。

并行开两个会话，互不踩脚。 用 git worktree 给每个会话一份独立检出：

claude --worktree feature-auth

在第二个终端用不同名字再跑一次，就是隔离的并行会话（仓库需要至少有一个提交）。

把 Claude Code 当 Unix 工具用。 管道进出，适合批处理和 CI：

git log --oneline -20 | claude -p "summarize these recent commits"

盯用量、调力度。 会话里 /usage 看用量花在了哪——订阅档（Pro/Max/Ultra/Team/Enterprise）会按技能、子代理、插件、MCP 服务器细分；/effort high 让它多想（疑难 bug），/effort low 让它快出草稿（你在旁边逐步把关）。

贴图也行。 报错截图直接 Ctrl+V 粘贴（Windows/WSL 用 Alt+V），或拖进窗口，然后问 Here's a screenshot of the error. What's causing it?。

本课小结

✅ Claude Code 教程的日常主线 = 进目录启动 → 具体派活 → @ 喂文件 → 大改动开 plan → /diff 检查后提交 → Esc//clear/--continue 收尾。 六步转起来，它就是终端里随叫随到的编程代理。

✅ 它是代理不是聊天框：自己读代码库、编辑文件、跑命令、操作 git——你负责说清「做什么、在哪做、做成什么样」。

✅ 四种形态一套引擎：终端 CLI（本课）、VS Code/JetBrains 插件、桌面应用、网页版 claude.ai/code；CLAUDE.md、设置、MCP 全形态通用。

✅ 可控性三件套：auto 模式拦风险操作、plan mode 先审方案、/diff + git 兜底回退。

✅ 提示词心法：文件 + 症状 + 验收标准；要完整版加 be ambitious；纠正两次不对就 /clear 重写。

关键操作回顾：

操作	怎么做	说明
启动会话	cd 项目目录 后运行 claude	提示符上方显示版本/模型/工作目录
派活	直接打字描述任务	说清文件、症状、验收标准
喂文件	@src/utils/auth.js	单文件默认 ≤25,000 tokens 进入对话
跑命令	! npm test	输出进对话，Claude 自动回应
开计划模式	claude --permission-mode plan 或 Shift+Tab	状态栏显示 ⏸ plan mode on
查改动	/diff	列出改动文件与增删行数
提交/开 PR	commit my changes with a descriptive message / create a pr	它直接操作 git
续会话	claude --continue（最近）/ claude --resume（挑选）	无会话时打印 No conversation found to continue

下一课预告

Claude Code 用顺了，下一课看 OpenAI 阵营的对位工具：Codex 用法：OpenAI 的本地编码代理。

你会学到：

• Codex 是什么：官方定位「在你电脑本地运行的编码代理」，和 Claude Code 的代理思路有何异同
• 用 ChatGPT 账号登录 Codex CLI 的流程（codex 后选 Sign in with ChatGPT）
• Codex 的四种形态：CLI、IDE 扩展、桌面端 codex app、网页版
• 两款工具怎么选、怎么搭着用——费用全表见 价格对比