ShiBin's Wiki

Appearance

Published at:

Claude Code 培训指南 ​

什么是 Claude Code ​

Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具。与传统 AI 代码补全（如 GitHub Copilot）不同，它不只是给出一行建议，而是像一个真正的工程师一样：读懂你的项目、自主操作文件、执行终端命令、管理 Git 工作流——全程与你对话协作。

它的核心定位是一个 命令行/IDE 层的 AI Agent，而非代码补全插件。你可以把它理解为：一个驻扎在你终端里的、会写代码的同事。

核心概念：Agent 与模型 ​

初次接触 Claude Code 时，最容易混淆的是 Agent 和 模型 的关系。理清这两个概念，才能正确理解 Claude Code 的工作方式。

Claude Code 是什么？ ​

Claude Code 是一个 Agent——它是一个软件框架/工具，负责：

  • 管理你和 AI 模型之间的对话
  • 调用工具（读文件、写代码、执行命令、搜索网络等）
  • 控制权限（决定何时需要你的确认）
  • 维护上下文（CLAUDE.md、Memory、对话历史）
  • 协调多个模型的调度
flowchart TB subgraph SHELLS["🖥️ Shell / Client Layer (使用界面)"] direction TB E1["📟 CLI<br>(终端命令行)"] E2["🌐 Web UI<br>(claude.ai/code)"] E3["💻 VSCode 扩展<br>(推荐)"] E4["🧩 JetBrains 插件<br>(IntelliJ/PyCharm)"] E5["🖲️ Desktop App<br>(独立应用)"] end SHELLS --> AGENT subgraph AGENT["Claude Code (Agent)"] direction LR subgraph CORE["🧠 Core Runtime"] direction TB A1["对话 / 规划"] A2["工具编排"] A3["权限与安全控制"] A4["上下文管理<br>(CLAUDE.md / Memory)"] A5["会话管理<br>(Save / Resume)"] end subgraph TOOLS["🔧 工具系统"] direction TB B1["文件系统"] B2["终端 / Shell"] B3["Git 集成"] B4["Web 搜索 / 获取"] B5["MCP 服务器"] B6["网络请求"] B7["图像 / PDF 读取"] end subgraph EXT["🧩 扩展生态"] direction TB C1["Skills<br>(技能 / 工作流)"] C2["Plugins<br>(MCP 插件)"] C3["Hooks<br>(事件钩子)"] C4["斜杠命令<br>(/help 等)"] C5["键盘快捷键<br>(Keymap)"] end end AGENT --> API["调用模型 API"] subgraph MODELS["🤖 模型层"] direction TB subgraph OFFICIAL["Anthropic 官方模型"] D1["Claude Opus 4.7"] D2["Claude Sonnet 4.6"] D3["Claude Haiku 4.5"] end D4["第三方模型<br>(DeepSeek / OpenAI 等)"] end API --> OFFICIAL API -. 通过 cc-switch 接入 .-> D4

Claude 模型家族 ​

模型是 Agent 的"大脑"——它提供理解和生成代码的智能。Anthropic 提供三个等级的模型：

模型定位特点适用场景总结
Claude Opus 4.7旗舰级最强推理、最深理解、最准代码复杂架构设计、深度调试、跨文件大规模重构强
Claude Sonnet 4.6主力级性能与速度的最佳平衡日常编程、Bug 修复、功能开发（推荐默认使用）平衡模式
Claude Haiku 4.5轻量级最快响应、最低成本简单查询、代码格式化、文档整理快

三者使用完全相同的 Agent 框架和工具系统，区别仅在于推理能力和速度。

Agent 与模型的关系 ​

一个简单的类比： ​

Agent = 汽车（方向盘、油门、刹车、导航）
模型  = 发动机（提供动力）

换模型 ≈ 换发动机（同样的车，不同的马力）
Agent 的能力 ≠ 模型的智能（是两者的乘积）

具体来说：

  • Agent 决定"能做什么"：能读什么文件、能执行哪些命令、能否搜索网络、何时需要你确认——这些都是 Agent 层面的事，与使用哪个模型无关。
  • 模型决定"做得有多好"：代码质量、逻辑推理深度、对复杂需求的理解——这些取决于模型能力。Opus 写的代码可能比 Haiku 更优雅，但它们用的都是同一套工具。
  • 你可以随时切换模型：通过 cc-switch 在不同模型间切换（甚至接入 DeepSeek 等第三方模型），Agent 的行为框架保持不变，但输出质量会随模型而变化。

为什么这个区别很重要？ ​

理解 Agent 和模型的分离，能帮你做出更好的决策：

  • Agent 行为出问题（如改错文件、没读上下文）→ 检查 CLAUDE.md、对话状态、权限配置，换模型没用
  • 输出质量出问题（如代码不够好、逻辑不严谨）→ 切换到更强的模型（Sonnet → Opus）
  • 想省钱但 Agent 能力不受影响→ 日常用 Haiku/Sonnet，复杂任务切 Opus

平台生态 ​

产品列表：

产品平台安装/访问方式适用场景
Claude Code CLI终端 / SSHnpm install -g @anthropic-ai/claude-code远程服务器、无 GUI 环境、自动化脚本
Claude Code for VSCode ⭐VSCode扩展市场搜索 "Claude Code"日常首选 — IDE 深度集成，Diff 预览，侧边栏对话
JetBrains 插件IntelliJ / PyCharm / WebStorm插件市场搜索 "Claude Code"JetBrains 用户的 IDE 内体验
Web 界面浏览器claude.ai/code快速试用、临时任务、无需安装
Desktop 应用macOS / Windows官网下载独立桌面窗口，无需浏览器

Claude Code 支持多个平台，其中 VSCode 扩展是体验最完整的形态：

Claude Code CLI （功能最全的Client） ​

Claude Code CLI 是 Anthropic 提供的命令行原生交互方式，通过 npm 全局安装后即可在终端中使用。它拥有与 VSCode 扩展完全一致的能力，所有交互通过纯文本终端完成。

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

适用场景：

  • SSH 远程服务器：在开发机上无 GUI 环境时，CLI 是唯一选择
  • 自动化 & CI/CD：可通过非交互模式集成到脚本和流水线中
  • 习惯终端的开发者：Vim/Neovim/Emacs 用户、tmux 工作流
  • 轻量快速启动：无需打开 IDE，终端中直接 claude 即可开始对话

与 VSCode 扩展的差异：

方面CLIVSCode 扩展
交互界面终端纯文本侧边栏面板 + 编辑器 Diff
Diff 审查纯文本 diff内联双栏 Diff 预览，逐文件 Accept/Reject
文件上下文手动指定或靠对话上下文自动感知打开的文件和选中文本
安装方式npm install -gVSCode 扩展市场安装

CLI 的 Diff 回退体验虽然不如 VSCode 扩展直观，但在远程开发和自动化场景中不可替代。建议本地开发使用 VSCode 扩展，远程/自动化场景使用 CLI。

Claude Code for VSCode（推荐） ​

VSCode 扩展是目前体验最完整、社区使用率最高的方式。它在 VSCode 侧边栏中嵌入完整的 Claude Code 终端，并与 VSCode 的 IDE 能力深度融合。

核心交互模式：

交互方式操作说明
侧边栏对话Cmd+Shift+L 打开面板主交互区，支持多轮对话、文件 Diff、终端输出
内联编辑Cmd+Shift+I 打开输入框光标处直接输入指令，结果内联展示在代码旁边
右键菜单选中代码 → 右键快速触发 "Ask Claude" "Explain Code" "Fix This" 等
选中即上下文选中代码后提问Claude 自动将选中内容作为上下文，无需手动粘贴

IDE 深度集成能力：

  • 内联 Diff 预览：所有代码修改以双栏 Diff 形式呈现，逐文件审查，一键 Accept/Reject
  • 终端集成：Claude 执行命令的输出实时显示在 VSCode 终端中，支持中断和重试
  • 文件感知：自动感知当前打开的文件、光标位置、选中文本，无需手动指定上下文
  • 诊断信息感知：能读取 VSCode 的错误提示、警告、lint 结果，辅助修复
  • 快捷键体系：完整的快捷键绑定，常用操作无需离开键盘
  • 跨文件编辑预览：多文件变更统一展示，查看整体改动后再决定是否接受

为什么 VSCode 扩展是最佳选择？

CLI:          对话在终端，Diff 在终端 —— 纯文本，但缺少图形化审查
VSCode 扩展:   对话在侧边栏，Diff 在编辑器 —— 可视化变更，所见即所得

对于代码审查、多文件重构、UI 开发等需要可视化反馈的场景，VSCode 扩展的 Diff 视图远胜于终端的纯文本 diff。

本指南以 VSCode 扩展为主要介绍对象，大部分功能在不同平台通用。

快捷键一览 ​

常用快捷键的 Mac / Windows 对照：

操作MacWindows / Linux
打开/聚焦侧边栏Cmd+Shift+LCtrl+Shift+L
内联编辑Cmd+Shift+ICtrl+Shift+I
提交新消息EnterEnter
换行（不提交）Shift+EnterShift+Enter
中断 AI 响应Ctrl+CCtrl+C
打开快捷键设置Cmd+K Cmd+SCtrl+K Ctrl+S
全屏侧边栏Ctrl+Shift+JCtrl+Shift+J
选中代码 → 问 ClaudeCmd+ICtrl+I
审批上一个 DiffCmd+EnterCtrl+Enter
拒绝当前变更Cmd+DeleteCtrl+Delete
切换主题 (深色/浅色)Cmd+K Cmd+TCtrl+K Ctrl+T
打开设置Cmd+,Ctrl+,

提示：你可以通过 VSCode 的 Keyboard Shortcuts 设置页面搜索 "Claude" 来自定义所有快捷键绑定。

JetBrains 插件 ​

面向 IntelliJ / PyCharm / WebStorm 用户，体验与 VSCode 扩展类似，提供侧边栏面板和内联 Diff。

Web 界面 ​

通过 claude.ai/code 直接使用，无需安装任何软件。适合快速试用或临时任务。

核心理念：Agentic Coding ​

理解 Claude Code，关键在于理解 Agentic Coding：

传统开发：你写代码 → AI 给建议 → 你决定是否采纳
Agentic Coding：你描述需求 → AI 自主调研 → AI 执行操作 → 你 Review 结果

这意味着你的角色从 写代码的人 变成了 定义方向 + 审查结果的人。Claude Code 帮你处理中间的执行细节。

学习路径 ​

本指南按渐进顺序组织，建议按序阅读：

  1. 安装与设置 — 安装配置，使用 cc-switch 切换模型
  2. 工作原理 — 理解 Agent Loop 和工具系统
  3. 核心功能 — 从基础对话到高级 MCP 扩展
  4. 生态与社区 — Skills、Plugins、CLAUDE.md 编写规范
  5. 实战工作流 — 真实项目场景中的使用模式
  6. 角色转变与局限 — 使用后的思考和注意事项
  7. Cheatsheet — 常用命令与快捷键速查

如果你已经完成安装，可以直接跳转到 核心功能 开始实战。

Copyright © 2017-2026 Shi Bin