Claude Code 完整教程（2026）

现在人们说的 Claude Code 是什么

2026 年公开材料里的 Claude Code，是 Anthropic 面向仓库的编程 Agent：它读代码、改文件、跑命令，并接上你的其他工具。同一套引擎出现在终端、编辑器扩展、桌面应用和浏览器里。

它不是聊天框里贴片段的页面。你把会话落在项目目录，说出任务，再审 diff。文档入口在 code.claude.com。本教程只写公开、可核对的用法。

能否使用通常取决于付费 Claude 方案或 Anthropic Console / API 账号。免费网页对话和 Code 权限不是一回事。套餐、地区和门槛会变。我们不写价格。

博客和安装页打架时，以官方文档和你机器上 claude doctor 的输出为准。

• 终端：进入项目后运行 claude。
• IDE：VS Code、Cursor、JetBrains 的官方扩展。
• 桌面应用：不想用终端时的图形入口。
• 网页与 GitHub：长任务，以及公开谈过的 @claude 类提及。

这套教程写给谁

已经会用 git 和终端、想把 Agent 放进自己仓库的人。不必先上提示词课。

只想问语法，用普通 Claude 对话就够。如果日常已经是 Codex 或 Cursor，对照章仍值得读。

团队可以共享 CLAUDE.md、技能和 MCP。第一周仍从一台电脑、一个练习仓库开始。

• 能打开终端并运行 git status。
• 能撤回一次糟糕的改动。
• 不会把密钥贴进提示。

四扇门，一套仓库习惯

第一周只选一扇门。本教程默认终端，因为安装、doctor 和 PATH 问题最先出现在那里。

桌面端给不想住在 shell 里、又要看 diff 的人。IDE 扩展让你待在文件树旁边。网页和云端任务适合笔记本合上的时候。

CLAUDE.md、技能和 MCP 本就该跨入口复用。不要给编辑器再发明一份说明书。

• 能装 CLI 就先终端。
• 终端是障碍再用桌面端。
• CLI 能跑后再上 IDE。
• 本地 diff 跑通后再上 GitHub 和网页。

八章怎么读

第 1 到 3 章：装通二进制并完成一个可回看的任务。第 4 到 6 章：说明书、技能、一台 MCP。第 7 章对照 Codex。第 8 章是修理包。

只有前面的门槛已经成立才跳读。PATH 里没有 claude，不是 CLAUDE.md 的问题。

登录或 PATH 已经坏了，先去排错章，再回来。

1. 它是什么：名称、入口、以及它不是什么。
2. 安装：原生脚本、brew 或 WinGet、PATH、doctor。
3. 第一个任务：一小段能撤回的 diff。
4. CLAUDE.md：短说明书。
5. 技能：一份可复用的剧本。
6. MCP：一台你能讲清楚的服务器。
7. 对照 Codex：为接下来一周选工具，不是选品牌。
8. 排错：doctor、PATH、重复安装、登录。

诚实的时间盒

一个专注的下午可以装完并做完一个任务。说明书和一项技能再花一个晚上。MCP 和对照可以放到周末。

不要同一天叠 Homebrew、WinGet、Node 全局包和桌面端下载。

• 安装和 doctor：20 到 40 分钟，含 PATH。
• 第一个任务：30 到 60 分钟，含真正审阅。
• CLAUDE.md 初稿：二十分钟写事实。
• 一项技能和一台 MCP：各留一个晚上。

你真的会敲的命令

原生安装后开一个新终端，进入项目，运行 claude。再跑 claude --version 和 claude doctor。安装命令从当天官方页抄，不要从旧 gist 抄。

2026 年默认是 macOS / Linux / WSL 的原生安装。Windows PowerShell 有自己的一行命令。Homebrew 和 WinGet 可用。全局 Node 包不再是本教程推荐的路。

• macOS / Linux / WSL：curl https://claude.ai/install.sh 再交给 bash。
• Windows PowerShell：irm https://claude.ai/install.ps1 再交给 iex。
• brew install --cask claude-code，或 winget Anthropic.ClaudeCode。
• 然后：新终端、claude、claude --version、claude doctor。

总览阶段的错法

把 Claude 对话、Claude Code 和随便一个编辑器主题当成同一个产品。

装了三份，却在调试错误的那一份二进制。

• 看到版本号就跳过 doctor。
• PATH 还没通就写 CLAUDE.md。
• 把社交媒体上的价格当真。

做到这样就够了

你能说出本周要用的入口，以及下一章打开哪一篇。

1. 知道这是仓库 Agent，不是贴代码聊天。
2. 今天只选终端或桌面端之一。
3. 会从 2026 官方页安装。
4. 先跑 doctor 再写文件。
5. 不会把 API 密钥提交进仓库。

本教程如何留余地

参数、默认模型和账号规则会变。我们写公开命令和文件习惯，不冻结某张设置截图。

不整段照抄 Anthropic 文档。今天早上参数改了，以安装页为准。

不写价格。有人问某个档位多少钱，请去官方定价页。

• 先看官方概述、安装页和产品页。
• doctor 输出优于博客记忆。
• 第 6 章之前只用一个练习仓库。

下一章：先把名字叫对

第 1 章把聊天产品 Claude 和仓库 Agent Claude Code 分开，并列入口。

若你已经能进可用的 claude 会话，第 1 章略读即可；doctor 不干净再去安装章。