Claude Code 工程 · 全景上手
学习舱 / Claude Code 工程 / 全景上手

Claude Code 全景与日常使用

整理中 深度 · 应用 更新 2026-09-09

前置 Agent

Claude Code 全景与日常使用

一句话定位:Claude Code 是住进你终端里的编码 Agent——本文从一次会话的解剖图讲起:权限怎么给、上下文怎么续、交互靠什么提速,看完能把它用成日常工具而不是玩具。前置:Agent 基础——知道「模型加循环加工具加刹车」是什么。

先从装好之后的三个问号说起

你跟着官方安装脚本跑了一行命令,在项目根目录敲下 claude,一个 AI 助手住进了你的代码库——它读你的文件、改你的代码、跑你的测试,第一次体验往往有点震撼。

震撼退去,三个问号浮上来:权限弹窗一个接一个,全部放行又心慌——信任边界该设在哪?聊了半小时它开始「变笨」,忘了开头说过的约定——上下文满了怎么办?还有几十个斜杠命令扑面而来——日常到底用得上几个?

这个产品的底盘是怎么设计的?权限、上下文、交互三条主线各是怎么组织的?

答案是三条线各有一个清晰的设计决策:权限是一组信任旋钮,从每步必批到完全放行分档可调;上下文靠自动压缩兜底、/compact 主动续命,/recap 在旁给人记进度;交互则围绕「斜杠命令 + 前缀快捷键」组织,常用动作不必离开键盘。先看全景:

一次会话的解剖:从输入到落地 ① 你的输入 自然语言 / 斜杠命令 ! 命令 · @ 文件 ② 上下文窗口 CLAUDE.md + 对话 + 工具结果 满员前自动压缩 /compact 主动瘦身 ③ 权限门(六档) 读免批 · 写与命令需批 Shift+Tab 循环切档 编辑/计划/全自动各有其位 ④ 工具层:内置工具集 + MCP 扩展 读/搜/改/跑命令 · 子代理 · 任务清单 · 联网两件 · MCP 外援 ⑤ 你的项目环境(代码、git、终端、测试) /recap 给人记进度 400 字符内的回顾 不动上下文 读法:①→②→③→④→⑤ 是一次请求的主路;/recap 是旁路,随时要、不占上下文

图:一次会话的解剖——①输入 ②上下文 ③权限门 ④工具层 ⑤项目环境;/recap 是给人看的旁路

渐进拆解:信任旋钮、上下文续命、键盘流

类比:把 Claude Code 想成你刚入职的一间实验室。权限模式是一组信任旋钮(像门禁卡的档位:访客每进一间房都要登记,资深员工刷卡直行);上下文是实验室的白板(写满了要擦了重写,擦之前拍照存档);斜杠命令与前缀快捷键是墙上贴的操作面板(不用每次都喊人来按);内置工具集则是出厂配好的工具墙(每件都是一类基本操作,没有重复职能)。四样合起来,决定这间实验室「用起来顺不顺」。

支持平台与安装

  • 官方支持 macOS(13.0+)、Windows(10 1809+)、Linux;终端 CLI 是本体,另有桌面应用与 IDE 插件。
  • 安装首选官方脚本(macOS/Linux 一行 curl,Windows 走 PowerShell),npm 全局装是备选。
  • 到 2026 年 9 月,版本线已走到 2.1.x,工具表里能见到 LSP(代码智能)、Monitor(后台盯日志)等新名字,外加 agent teams(多代理协作)这类新特性——迭代速度是这个产品的基本特征,本文讲的是稳定骨架,细节以官方文档为准。

权限模式与切换(③门禁)

官方共六档:

  • default(Manual):每个工具首次使用都问。
  • acceptEdits:自动接受文件编辑与常见文件系统命令。
  • plan:只读探索不出手,先出计划。
  • auto:后台安全检查自动放行。
  • dontAsk:没预批的一律拒绝。
  • bypassPermissions:全跳过,官方建议只在容器或虚拟机里用。

会话里 Shift+Tab 循环切档,日常最顺的组合是「默认档进门、acceptEdits 干活、plan 档探索陌生代码库」——信任旋钮拧到哪一档,取决于你让它在什么后果的代码上工作。

上下文续命(②白板)

上下文窗口不是无限大,聊久了必然满——这是 Agent 产品的共同约束(Context 工程整篇讲的预算问题,在产品层就落在这里)。Claude Code 的做法是两层加一条旁路:

  • 满员前自动压缩兜底,用户无感。
  • /compact 主动续命,可带一句聚焦指令(「只保留与登录 bug 相关的结论」),压缩后对话继续。
  • /recap 是给人看的旁路——按需生成 400 字符以内的进度回顾,自动版在对话满三轮、终端失焦约三分钟后后台生成,不会连续两次触发(/config 里可关),且不动上下文一字。

一个给模型续命,一个给人交接,别再用混。

交互键盘流(①面板)

斜杠命令管「调产品功能」(/compact、/clear、/resume、/mcp、/statusline……),前缀快捷键管「改输入走向」:

  • ! 直接跑 shell 命令:输出进对话,模型自动接话,无需它批准。
  • @ 引文件:路径自动补全。

状态行自定义(/statusline)让模型帮你写一条常驻状态栏——分支名、token 消耗、当前模式,随你配。TUI(终端文本界面)的渲染器分全屏与经典两档(/tui 可查当前档),全屏档另有转录查看器与全屏搜索,深度用户可开 vim 编辑模式。

内置工具集为什么是这几件(④工具墙)

官方工具表的核心是一组「作用通道」:

工具通道职能需批与否
Read / Glob / Grep读文件、找文件、搜内容——只进不出免批(工作目录之外的路径仍会询问)
Edit / Write改文件——出手就有后果需批
Bash(Windows 上另有 PowerShell 原生档)跑命令——出手就有后果需批
WebFetch / WebSearch联网两件——
Agent(子代理)独立上下文干脏活——
任务清单创建/更新/查状态——
MCP 外援接口接外部工具服务的标准接口(协议本身见 MCP 那篇)——

多了什么?没有「写代码专用工具」——写代码就是 Edit 加 Bash 的组合,通道正交不重叠。少了什么?没有独立的 GUI 操控、没有内置浏览器——这些靠 MCP 外援补。工具集的设计判据是:每一件都是模型与真实环境之间一类不可替代的作用通道,而不是某个具体功能。

MCP 扩展怎么接(⑤落回项目环境)

产品层的 MCP 配置有三种作用域:

  • 本地(默认):只在你这台机器的这个项目生效。
  • 项目:.mcp.json 放项目根,随 git 入库共享给全组。
  • 用户:跨你所有项目生效。

协议本身讲什么,上面那篇已经展开;这里只需记住:内置工具是出厂配好的工具墙,MCP 是外购的扩展件,/mcp 命令随时查看连接状态——所有能力最终都落在⑤你的项目环境上。

动手:五分钟把日常流跑顺

新会话五连,每个动作都可立即复制(# 后是注解,不是要输入的内容):

claude                              # 项目根目录进入会话
@src/api/auth.ts 这个文件有注入风险吗?  # @ 引文件(换成你项目里的任一文件):路径自动补全
!npm test                           # ! 直跑命令:输出进对话,模型自动接话
/compact 只保留鉴权 bug 的结论与下一步   # 聚焦压缩:上下文瘦身且不丢重点
/recap                              # 要一份 400 字符内回顾:发给同事交接

中途按一次 Shift+Tab 切到 acceptEdits 档,文件编辑的弹窗立减。再花一分钟配状态行:输入 /statusline 用一句自然语言描述想要的内容(「显示当前分支和剩余 token」),模型把配置写好——这是产品「用 Claude 改造 Claude」的典型口味。MCP 外援则从项目根的 .mcp.json 入库开始,全组共享同一份工具清单。

三个命令的分工一张表记住(口径均来自官方文档):

命令官方定义(意译)给谁看上下文影响
/compact总结对话腾出空间,可带聚焦指令模型(续命)整段重写为摘要
/recap按需生成回顾,自动与手动版均限 400 字符人(进度与交接)不动上下文
/clear开新会话,可给上一个命名便于 /resume 找回——彻底清空

边界与取舍:旋钮拧到哪一档

权限档位是信任问题,不是效率问题

弹窗烦的最高效解法是 bypassPermissions 一档到底,但官方文档明说它连受保护路径的写入都直接放行、建议只在隔离环境用。合理的取舍按「出错后果」定档:个人玩具项目可以 acceptEdits 起步;生产仓库保持 Manual 或 plan 档探索、关键编辑逐个过目;团队共享环境用 settings 预写允许清单,把「必批」收敛到真正高危的动作上。六档放一条轴上看:

权限六档:跟着「出错后果」选档 default(Manual) 每个工具首次使用都问 acceptEdits 文件编辑自动通过 auto 安全检查自动放行 bypassPermissions 全跳过 · 限隔离环境 plan(特殊档) 只读探索,先出计划 dontAsk(特殊档) 没预批的一律拒绝 放权与自动化程度 →(虚线两档不在此轴上:plan 管只读探索,dontAsk 管预批制)

图:权限阶梯——主轴四档逐级放权;plan(只读探索)与 dontAsk(预批制)是挂在轴外的两个特殊档

自动压缩不是记忆管理的全部

压缩保的是「对话能继续」,不保「重要结论不丢」——被压缩掉的细节不会回来。所以长任务的关键约定(选型决策、踩过的坑)要么写进 CLAUDE.md(项目的持久指令文件,下一站的主角)这类持久层,要么定期 /recap 留档给人。产品行为的细节与记忆分层,CLAUDE.md 与记忆系统整篇展开。

别把速查表当学习路径

斜杠命令几十个,日常高频其实就是本文这几个:/compact、/recap、/clear、/resume、/mcp、/statusline,加 ! 与 @ 两个前缀。其余的进阶机制(Skills、Hooks、Plugins)本系列各有一篇——用熟骨架再挂扩展,顺序别反。

自测

合上文章先自己答,再展开对照:

/compact 和 /recap 各自解决什么问题?什么时候主动用哪个?

/compact 解决「上下文满了、对话继续不下去」——把整段对话重写为摘要腾出空间,可带聚焦指令保留重点,是给模型的续命手段;长会话中段主动用,换新话题前主动用。/recap 解决「人不知道这场会话干了什么」——按需生成 400 字符以内的进度回顾,不动上下文,是给人的交接手段;中途要向同事同步、或收工留档时用。一句话:给模型续命找 /compact,给人留进度找 /recap;另外自动压缩满员前就会发生,但只有 /compact 能带聚焦指令。

内置工具集为什么是这个组合——多了什么、少了什么?

组合判据是「一类不可替代的作用通道」:读文件(Read)、找文件(Glob)、搜内容(Grep)是只进不出的信息通道,免批;改文件(Edit/Write)、跑命令(Bash/PowerShell)是改变环境的出手通道,需批;再配联网(WebFetch/WebSearch)、委派(Agent 子代理,独立上下文)、任务清单与 MCP 外援接口。多出来的都是正交通道——没有「写代码专用工具」,写代码就是 Edit 加 Bash 的组合,通道不按功能重叠设。少的是 GUI 操控与内置浏览器这类非核心编码通道,需要时靠 MCP 接外部服务补位。

参考与延伸

下一站:CLAUDE.md 与记忆系统——压缩保对话,记忆保约定:产品把「记住你」分成了几层。

本节点大纲与自测题(5 个子点 · 2 问)

大纲

  • 支持平台、安装方式与内置工具概览
  • 权限模式与切换、会话管理、状态行自定义
  • TUI 全屏与普通模式、快捷前缀 / ! @、常用命令速查
  • /compact 与 /recap 的区别与使用时机
  • MCP 扩展工具的配置(.mcp.json、作用域)

自测——答不上来就是缺口

  • /compact 和 /recap 各自解决什么问题?什么时候主动用哪个?
  • 内置工具集为什么是这个组合——多了什么、少了什么?