Claude Code 概览

这一课你将能做到

1. 说清楚 Claude Code 与网页版 AI 聊天、IDE 补全工具（如 Copilot）的本质区别
2. 在 Windows / macOS / Linux 上完成安装与登录，跑通第一个真实编码任务
3. 用「中断（Esc）— 权限确认 — 恢复会话（claude -c）」三个基本操作驾驭一次完整对话

为什么要学

ChatGPT、网页版 Claude 这类工具的本质是「你问它答」，代码要你自己复制粘贴。Copilot 这类补全工具只在光标处帮你续写几行。而 Claude Code 是一个运行在终端里的 agentic（智能体式）编码工具：它能自己读你的项目文件、自己执行命令、自己修改代码、自己跑测试，然后根据结果继续下一步——你只需要描述目标和审查结果。

人话：以前 AI 是「顾问」，只出主意；Claude Code 是「初级工程师」，直接上手干活，每一步重大操作还会先举手向你请示。

对开发者来说，它覆盖最高频的日常工作：定位 bug、写功能、重构、补测试、code review、生成 commit。对面试来说，「如何与 coding agent 协作」「如何控制 agent 的权限与风险」正在成为高频话题。

先建立图像

你在项目根目录输入 claude 后的一轮典型对话长这样：

你：结算接口偶尔超时，帮我查一下
Claude Code：
  ├─ Grep  搜索 "settle" 相关代码        → 找到 3 处引用
  ├─ Read  读取 SettleService.java       → 发现线程池固定 2 个核心线程
  ├─ Bash  运行相关单元测试               → 复现偶发超时
  └─ Edit  建议把核心线程数改为 8         → 弹出权限确认
你：允许这次修改
Claude Code：已修改并重跑测试，全部通过。需要我生成 commit 吗？

关键在左侧那些动作：Grep、Read、Bash、Edit 是它内置的工具（Tool）。模型负责「想」，工具负责「做」，这个「想→做→看结果→再想」的循环就是 agent 的核心。

跟着做

步骤 1：安装

任选其一（需要 Node.js 18+ 或使用原生安装脚本）：

# 方式 A：npm 全局安装（跨平台通用）
npm install -g @anthropic-ai/claude-code

# 方式 B：macOS / Linux 原生安装
curl -fsSL https://claude.ai/install.sh | bash

# 方式 C：Windows PowerShell 原生安装
irm https://claude.ai/install.ps1 | iex

装完在新开的终端里验证：

claude --version

步骤 2：首次启动与登录

cd 你的项目目录
claude

首次启动会引导登录：订阅用户（Pro / Max）选「Claude account」，按浏览器授权流程走完即可；API 用户选「Anthropic Console」，使用按量计费的 API Key。

步骤 3：第一问——让它认识项目

在交互界面里直接输入（不用任何斜杠命令）：

这个项目的整体结构是什么？入口在哪？用什么构建命令？

观察它会自动调用工具浏览目录和文件，最后给你一份摘要。这一步不改任何东西，放心执行。

步骤 4：第一改——修一个小问题并观察权限

给它一个明确的小任务：

把 README 里过期的时间从 2023 全部更新为 2026

当它准备调用 Edit 工具时会弹出权限提示，通常有三个选项：本次允许、本会话内不再询问、始终允许（写入配置）。初学者建议先逐次确认，熟悉它的行为模式后再放开。

步骤 5：中断与恢复

• 它正在输出但方向不对：按 Esc 随时打断，直接说新指令。
• 退出会话：输入 exit 或按 Ctrl+C 两次。
• 恢复最近一次会话：终端里执行 claude -c；想挑选历史会话用 claude -r。

讲清楚要点

1. 终端是主战场：Claude Code 的完整能力在 CLI 里，官方还提供 VS Code / JetBrains 扩展，可在编辑器里直接选中代码提问、共享诊断信息，底层是同一套能力。
2. 工作目录即作用域：你在哪个目录启动 claude，它默认就在那个目录树下工作。子目录、父目录的文件可以通过引用或 /add-dir 纳入。
3. 它默认不乱来：读文件、搜索一般直接执行；写文件、执行命令这类有影响的操作默认要过权限关。权限体系后面有专门一课。
4. 订阅与 API 两条付费线：订阅（Pro/Max）按月付、有用量上限，适合日常高频使用；API 按 token 计费，适合自动化与按需场景。成本控制也有专门一课。
5. 会话是有状态的：同一会话里它记得你们聊过的内容；claude -c / -r 能接续，/clear 才是真正清空。

你可能会懵的地方

• 它和 Copilot 有什么区别？ Copilot 是「光标处的补全」，主动权在你，逐行给建议。Claude Code 是「任务级的代理」，你给目标，它自主完成探索、修改、验证的整条链路。两者不冲突，可以同时用。

• 我的代码会被上传到哪里？ 与模型的每次交互都会把相关上下文发给 Anthropic 的 API 处理，这与使用任何云端大模型一致。区别在于「发多少」：它只按需读取相关文件，而不是整库上传。企业环境可关注官方的数据隐私与合规说明。

• 它会不会把我的项目改坏？ 默认权限模型下，每个文件修改都要你确认，且可以配合 git 使用——随时 git diff 审查、git restore 回滚。把「放权」建立在版本控制之上，是最稳的姿势。

• 只会在终端里用吗？我不熟终端。 终端交互其实只有「输入指令 + 几个快捷键」，半小时就能习惯。不想开终端，可先装 VS Code 扩展，体验一致。

• 和网页版 Claude 有什么区别？ 网页版看不到你的本地代码、执行不了本地命令。Claude Code 的价值恰恰是「长在你项目里」：能读真实代码、跑真实测试，给出的结论是基于事实而非猜测。

错法对照

错法	问题	正解
把它当搜索引擎，一句话不给上下文	输出泛泛而谈	给清目标、现状、约束三要素
一上来就让它「重写整个项目」	范围失控，diff 巨大无法审查	拆成小任务，逐个确认
不用 git 就开始让 agent 改代码	改坏了无法回滚	干净的工作区 + 随时 git diff
每个权限都选「始终允许」	等于裸奔，危险命令不再拦截	只对安全命令放开，写精确规则
出问题就关终端重开	会话上下文白丢	先 Esc 打断纠偏，或 claude -c 恢复

卡点急救

1. claude: command not found：安装后没开新终端，或 npm 全局目录不在 PATH。重开终端，或用 npm config get prefix 检查全局路径并加入 PATH。
2. 登录卡住 / 授权失败：执行 /doctor 体检，按提示修复；企业内网注意代理设置。
3. 回复到一半不动了：按 Esc 中断，重新描述要求；如果会话状态已乱，claude -c 恢复或 /clear 重来。

面试常问

• 什么是 agentic coding？和普通 LLM 编码助手有何区别？ agentic coding 指模型以「目标驱动 + 工具调用」的方式自主完成多步任务：规划→读代码→改代码→执行验证→迭代，而不是一次性生成文本。区别在于有无「行动能力」（工具）与「闭环」（根据执行结果自我修正）。

• Claude Code 如何避免危险操作？ 三层机制：交互式权限确认（每次敏感操作弹窗）、权限规则配置（settings.json 中 allow/ask/deny）、权限模式（如 Plan 模式只读探索）。还可配合 Hooks 在工具调用前后强制执行检查脚本。

• 为什么这类工具选择在终端运行？ 终端是开发者环境的「最低公共分母」：不依赖特定 IDE，能直接复用 shell 命令生态，天然适合与 CI/CD、脚本、远程服务器集成，也便于以 headless 方式做自动化。

自测三问

1. Claude Code 完成一轮任务的核心循环是什么？
2. 如何中断当前回复、如何恢复上一次会话？
3. 权限提示的三个选项分别意味着什么？

小结一句话

Claude Code 是长在终端里的编码智能体：你给目标，它用工具自主完成「读—改—验」，你用权限确认和 git 守住安全边界。

延伸

• Claude Code 官方概览文档
• 下一课：工作流与 Plan 模式——学会「先探索、再规划、后动手」的规范节奏，避免让 agent 一把梭。