Claude Code 完全指南:从安装到实战,手把手教你用 AI 写代码

Claude Code 完全指南：从安装到实战，手把手教你用 AI 写代码

2026年05月14日 · AI技术前沿

它到底是什么？

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。一句话概括：你在终端里用自然语言跟它聊天，它直接在你的项目里动手改代码。

不同于网页版 AI 需要你来回复制粘贴，Claude Code 能直接读取你的整个项目、创建文件、修改代码、运行命令，甚至通过 MCP 连接数据库和外部 API。

同类型的工具还有 Codex 和 OpenCode，但 Claude Code 是目前生态最完善的一个。

---

和普通 AI 有什么不同？

维度	普通 AI（网页版）	Claude Code
交互方式	复制→粘贴→复制→粘贴	直接在项目里操作，零切换
上下文	你给什么，它知道什么	自动读取整个项目代码
执行力	只能给建议和代码片段	直接创建文件、改代码、跑测试
记忆	每次对话独立	CLAUDE.md + Memory 记住项目规则
工具调用	无法调用外部工具	MCP 连接浏览器、数据库、GitHub

核心区别：它不只是聊天，而是能直接帮你动手做事。

---

安装教程（按顺序执行）

第一步：安装 Git（Windows 用户必须）

Claude Code 在 Windows 下需要 Git Bash 环境。

✓ 访问 https://git-scm.com/install/windows

✓ 下载安装包，一路默认设置即可

✓ 安装完重启终端

Mac 和 Linux 用户通常自带 Git，可以跳过。

第二步：安装 Node.js

Claude Code 基于 Node.js 运行，需要 18+ 版本。

验证是否已安装：

bash

node --version

如果显示 v18.x.x 或更高，直接下一步。如果报错，去 https://nodejs.org/ 下载 LTS 版本安装。

第三步：安装 Claude Code

方案一：官方脚本（需科学上网）

bash

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

方案二：npm 安装（推荐，更稳定）

bash

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

第四步：安装 CC-Switch（可选但推荐）

CC-Switch 是 Claude Code 的版本切换工具，方便在不同版本间切换。

下载地址：https://github.com/farion1231/cc-switch

第五步：更新

bash

claude update

---

安装完成之后，控制台输入 claude 成功启动即可

三种工作模式，用对场景效率翻倍

Claude Code 提供三种模式，对应不同的工作场景：

🛡️ Default 模式 — 安全优先（默认）

特点： 执行任何操作前都会请求你的确认。

每次权限提示时，你有五个选择：

输入	含义	作用范围
`y`	Yes	仅允许本次操作
`a`	Always allow	允许此类操作，本次会话不再询问
`n`	No	拒绝此次操作
`e`	Edit	修改命令后执行

适合： 初学者、敏感操作、不熟悉的新项目。

⚡ Auto 模式 — 高效执行

特点： 自动完成操作，减少确认步骤。

适合： 熟练用户、重复性任务、已建立信任的项目。

注意： 安全级别较低，建议只在熟悉的环境中使用。

📋 Plan 模式 — 规划先行

特点： 只规划不执行，适合复杂任务的方案设计。

Claude 会给出详细的执行计划，但不会修改任何文件。你可以先审阅计划，确认无误后再切换到 Default 或 Auto 模式执行。

适合： 复杂任务的前期规划、团队协作时的方案讨论。

---

常用命令速查

命令	作用
`/init`	初始化项目，生成 CLAUDE.md
`/model`	更换模型
`/status`	查看当前状态
`/continue`	恢复历史会话
`/plugin`	插件管理
`/compact`	压缩会话（上下文太长时用）

---

快捷键

快捷键	作用
`Shift + Enter`	换行输入
`Esc` 按两次	浏览历史命令
`quit`	退出 Claude Code
`Ctrl + C` 按两次	强制退出
`Shift + Tab`	切换模型

---

扩展机制：Skills / MCP / Plugins

Claude Code 的强大不仅在于内置能力，更在于它的扩展体系。

⚡ Skills — 用 Markdown 教 Claude 新技能

一句话概括： 用 Markdown 文件定义可重复执行的工作流，通过斜杠命令调用。

你可以把 Skill 理解为"宏命令"。比如创建一个"代码审查"Skill，里面定义了审查步骤和检查清单，以后只需要输入 /review 就能触发完整的代码审查流程。

工作原理（三层加载）：

✓ 技能发现 — AI 先读取所有技能的元数据，判断任务是否相关

✓ 加载核心指令 — 如果相关，自动读取 SKILL.md 的详细指导

✓ 加载资源文件 — 只在需要时读取额外文件（如脚本、示例）

设置方法：

bash

# 全局级（所有项目可用）
~/.claude/skills/

# 项目级（仅当前项目可用）
.claude/skills/

Skills 的优势：

✓ 自动触发：AI 根据任务自动加载相关技能

✓ 可复用 & 可共享：一次创建，团队共用，支持 Git 版本控制

✓ 高效利用上下文：渐进式披露，只加载需要的部分

✓ 跨平台：同一个 Skill 可以在 Claude、VS Code Copilot、Cursor 中使用

🔌 MCP — 给 Claude 装上"手脚"

一句话概括： 标准化协议，将 Claude 连接到你的数据库、API 和外部工具。

没有 MCP，Claude 被困在上下文窗口里；有了 MCP，它可以查询 SQL 数据库、调用任何 API、操控浏览器。

可以理解为 AI 领域的 USB-C 接口。

MCP 支持三种接入方式：

1. 远程 HTTP 服务器（适用于云服务）

bash

# 连接 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带身份验证
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer 你的令牌"

2. 本地 stdio 服务器（适用于本地工具）

bash

# 连接 Airtable
claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的密钥 airtable \
  -- npx -y airtable-mcp-server

3. 配置范围（控制可见性）

范围	用途	优先级
`local`	仅当前项目可用（默认）	最高
`project`	团队共享（存于 .mcp.json）	中
`user`	所有项目可用（个人全局）	低

配置完成后，MCP 工具始终可用，无需显式调用。用自然语言描述需求，Claude 会自动选择合适的工具。

📦 Plugins — 一键分发的工具箱

一句话概括： 将技能、子智能体、钩子和 MCP 配置打包成一个可安装的工具箱。

插件解决了"在我这能运行"的问题。不再需要每个团队成员手动配置 .claude/ 文件夹，一条安装命令，人人拥有相同的工具配置。

---

精选插件推荐

📄 Document-Skills — 文档处理与前端设计

包含 UI/前端设计、Word/PDF/PPT/Excel 处理、算法艺术、MCP 服务器构建、Web 测试等技能。

bash

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

🛠️ skill-creator — 用 Skill 创建 Skill

一个用来创建、测试、评估和改进其他 Skill 的工具。它本身就是一个 Skill。

✓ 引导你一步一步描述要创建的技能

✓ 自动输出正确格式的 SKILL.md

✓ 生成完整的目录结构（包括示例与资源）

✓ 支持迭代改进 Skill 内容

bash

/plugin marketplace add https://github.com/anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

🌐 chrome-devtools-mcp — 让 Claude 操控 Chrome 浏览器

让 Claude Code 直接操控你的 Chrome 浏览器，包括复用当前已登录的 Session。

要求： Chrome 144+ 版本

bash

# 安装
npx chrome-devtools-mcp@latest --help

# 配置 Claude Code MCP
claude mcp add --scope user --transport stdio chrome-devtools \
  -- npx -y chrome-devtools-mcp@latest --autoConnect --usageStatistics=false

配置完成后重启 Claude Code，首次连接时在 Chrome 中确认授权即可。

---

实战案例

案例一：文档排版

把一篇格式混乱的 Markdown 文档交给 Claude Code，它能自动调整标题层级、统一代码块格式、添加目录、优化排版。

案例二：整理电脑文件

"帮我把 Downloads 文件夹里所有的图片按日期分类整理到 Photos 文件夹。" Claude Code 会直接执行文件操作，不需要你手动拖拽。

案例三：网页数据抓取

"从这个网站抓取所有产品价格，存成 CSV。" Claude Code 会分析页面结构，写出抓取脚本，运行并导出数据。

---

写在最后

Claude Code 不是来替代程序员的，它是来放大程序员能力的。

那些重复性高、模板化的工作（写 CRUD、补测试、找 Bug、重构代码、整理文件），丢给它，几分钟搞定。省下来的时间，去做更有价值的事：理解业务、设计架构、做技术决策。

2026 年的编程，已经不是"你 vs 代码"，而是"你 + AI vs 问题"。会用 AI 的程序员，和不会用的，差距会越来越大。

跟着这篇指南装起来吧，10 分钟后你就能用上。

后续会讲解cc switch如何更换底层大模型。

💡 本文由 AI 辅助生成，观点仅供参考

🎯 关注「Java进步」，获取更多深度技术内容

每天更新 · 干货满满