Claude Code 完全指南：从安装到高级 Agent 工作流（2026 版）

如果你只是想\”装上 Claude Code 就开始改代码\”，看完前 3 节就够。如果你想把它从一个聊天框升级成\”团队里最熟练的那个工程师\”，那就要看完全部 10 节。

这篇是 PromptNet 的 Claude Code 母页面，串联站内 13+ 篇深度文（链接全文带），覆盖从第一次安装到自建 Agent 工作流的完整路径。

一、Claude Code 是什么：vs Cursor、Codex、网页版 ChatGPT

Claude Code 是 Anthropic 出品的官方终端 AI 编程工具，目前支持 4 种形态：

• CLI 终端版：npm install -g @anthropic-ai/claude-code，在任意项目目录直接 claude 启动
• Desktop 桌面应用（Mac / Windows）
• VS Code / JetBrains 扩展：编辑器内置面板
• Web 版（claude.ai/code）：浏览器内运行，无需本地装

它和市面上其他 AI 编程工具的本质区别在于运行模式：

一句话判断：你需要它读你整个项目并改多个文件——选 Claude Code；你只是写代码时想要补全——Cursor / Copilot；你只是问个概念——网页版 Claude / ChatGPT 就够。

详细横向对比见 Claude Code vs Cursor 选型分析。

二、安装与首次配置：5 分钟把环境跑起来

CLI 终端版（最常用）

前置：Node.js 20+。

npm install -g @anthropic-ai/claude-code
claude # 第一次运行会引导登录

登录走 OAuth 跳浏览器，不需要 API Key——只要你有 Claude.ai 账号（Pro / Max / Team / Enterprise 任意档），都可以直接用。

第一次进入项目

cd /path/to/your/project
claude

进入后第一条建议消息：让它读项目结构。

> 看一下这个项目，告诉我它是什么、用了什么技术栈

这一步看似多余，但能让 Claude Code 把你的项目结构、关键文件、依赖关系存进它的本地索引（CodeGraph / 项目快照），后续改代码效率高出 30%+。

完整新手流程见 Claude Code 怎么用：从安装到第一次改代码。

Windows / Linux 注意

• Windows 用 PowerShell 或 Git Bash，不要用 cmd（路径解析不一致）。
• WSL 里跑 Claude Code 比原生 Windows 体验好，文件 watcher 更稳。
• 终端宽度建议 ≥ 100 列，否则 diff 显示会折行。

三、三种核心模式：默认、Plan Mode、Fast Mode

Claude Code 在 2026 年正式分化出三种执行模式：

默认模式：什么都不做就是这个

用 Claude Sonnet 4.6，在性价比和能力之间最平衡的档位。日常改代码、写测试、修 bug 全用它就够。

Plan Mode：值得专门开一节讲

按 Shift+Tab 切入 Plan Mode，Claude 会先列出\”打算怎么做\”，让你确认后再动文件。

适合：

• 改动跨 ≥ 3 文件
• 不确定它会不会\”理解错你的意图\”
• 你不想被它写一堆没用的东西再回滚</