Claude、Claude Code 和仓库 Agent
Claude 既指模型家族，也指聊天产品。Claude Code 是落在项目目录里的仓库 Agent。同事说“我在用 Claude”，你要问他是网页、API，还是本机这条 claude 命令。
公开文档把它写成能读代码、改文件、跑命令、接其他工具的 Agent。这和编辑器边栏补全不是同一份工作。
发布周之后，名称以官方概述和产品页为准。本教程不把某个模型 id 冻成唯一答案。
桌面端、IDE 和网页会话仍然算 Claude Code。它们是门，不是另一套说明书。
你真正会碰到的入口
终端是完整 CLI：在项目里启动、对话、批准、看命令。安装痛苦多半是这里的 PATH 和登录。
IDE 扩展把 diff 放在文件树旁边。JetBrains 仍常常需要附近有 CLI。桌面应用给不想开 shell 的人。网页和移动端覆盖长任务和本地没有的仓库。
公开材料也会谈到 GitHub 自动化和 @claude 类提及。把它们当成后面的门，等本地审阅循环先通。
- 项目目录里的终端 CLI。
- VS Code / Cursor / JetBrains 扩展。
- 独立桌面应用。
- 浏览器和 GitHub 侧任务。
第一扇门开哪一扇
先问第一份 diff 你会在哪看。全屏终端就从 claude 开始。怕 shell 就用桌面端。已经住在某个编辑器，也等同一条二进制在终端能跑。
第一天开两扇门，就会有两份二进制和一条糊涂的 PATH。
- 本周只开一扇门。
- 无论哪扇门，CLAUDE.md 同一份。
- 本地成功后再上远程 GitHub 任务。
习惯怎么叠
始终生效的项目事实放进 CLAUDE.md。重复流程做成技能。仓库之外的系统走 MCP。
设置和额外文件可能落在 .claude 目录。不要从那里开始。先写短说明书。
doctor 用来看客户端有没有找到这些层。它是只读体检，不是一次会话。
- CLAUDE.md 写 Agent 会搞错的事实。
- 技能写你会重复的流程。
- MCP 接 git 树以外的系统。
- 用 doctor 看实际加载了什么。
它不是什么
它不是默默替你合并的 CI。diff 还是你看。
它不能替代 git、测试和代码评审。它可以暂存并开 PR，推送仍是你的。
它也不等于把文件贴进 claude.ai。未提交的笔记本改动，在你进入该目录的会话之前，仍是本地的。
- 不是贴片段的聊天机器人。
- 不是跳过测试的借口。
- 不是 git 之外的第二真相。
这周什么时候用它
好的第一份工作：解释一个目录、补一个测试、修你已经能复现的 lint、在开关后面写一个小函数。
糟糕的第一份工作：生产事故、轮换密钥、重写计费模块。
不能撤回，就还没准备好写会话。
- 练习仓库或你熟悉的小项目。
- 大声说清一条禁令：不提交或不通推送。
- 一条你自己能跑的校验命令。
先建立命令概念
安装是下一章。概念上你会开新终端、进入项目、运行 claude，再跑 claude --version 和 claude doctor。
若出现 command not found，那是 PATH，常见是 ~/.local/bin，不是模型宕机。
- 安装后换新终端。
- 在项目根运行 claude。
- claude --version 和 claude doctor。
命名阶段的错法
把每一个 Anthropic 窗口都叫 Claude Code。
以为桌面端和一份旧的 Node 全局包共用一份配置。
- 还不能启动就写说明书。
- 混用 Windows 原生和 WSL 家目录。
- 向团队承诺你发明的价格。
做到这样就够了
你能用一句话解释 Claude Code，并说出将要安装的入口。
- 能区分对话和 Code。
- 只选了一扇门。
- 知道有 doctor。
- 心里有一个练习仓库。
- 不会从 MCP 开场。
下一章：只装一份二进制
安装章走 2026 原生脚本，再写 brew 或 WinGet，并把 Node 全局包从默认路径拿掉。
带上新终端和项目路径。CLAUDE.md 留到第 4 章。