Claude Code 深度学习手册

主题

Claude Code 概览 ​

读代码、改文件、跑命令并接入开发工具的 agentic 编码工具。

是什么 ​

Claude Code 是一个 AI 驱动的 agentic 编码工具，能读取你的整个代码库、编辑文件、运行命令，并与你的开发工具集成，帮助你构建功能、修复 bug 和自动化开发任务。它理解你的整个代码库，并能跨多个文件和工具协同完成工作。

它有多种使用界面（surface）：Terminal CLI、IDE（VS Code、JetBrains）、Desktop app、Web 浏览器。每个界面都连接到同一个底层 Claude Code 引擎，因此你的 CLAUDE.md 文件、settings 和 MCP servers 在所有界面间通用。

怎么工作 ​

  • 提供多种运行界面：Terminal CLI（全功能）、VS Code/Cursor 扩展（内联 diff、@-mentions、plan review、会话历史）、JetBrains 插件、Desktop app（可视化 diff、并行多会话、定时任务、云会话）、Web（claude.ai/code，浏览器内无需本地环境）。
  • 自动化日常琐事：为未测试代码写测试、修全项目 lint 错误、解决 merge 冲突、更新依赖、写 release notes。
  • 构建功能与修 bug：用自然语言描述需求，Claude Code 规划方案、跨多文件写代码并验证；对 bug 可粘贴报错或描述症状，它会追踪根因并实现修复。
  • 直接对接 git：暂存改动、写 commit message、建分支、开 pull request；在 CI 中可用 GitHub Actions 或 GitLab CI/CD 自动化代码评审和 issue 分流。
  • 通过 MCP（Model Context Protocol）连接外部数据源（如 Google Drive、Jira、Slack 或自定义工具）。
  • 可定制：用 CLAUDE.md 设定规范、用 skills 封装可复用工作流（如 /review-pr）、用 hooks 在动作前后跑 shell 命令；还有 auto memory 自动跨会话保存学到的内容。
  • 支持 agent 团队与自定义 agent：sub-agents 并行协作、background agents（agent-view）一屏观察多个会话、Agent SDK 构建自定义 agent。
  • 遵循 Unix 哲学，可管道/脚本化/CI 集成（如 tail -200 app.log | claude -p "..."），详见 CLI reference。
  • 可定时运行：Routines（Anthropic 托管，电脑关机也运行，可被 API/GitHub 事件触发）、Desktop scheduled tasks（本机运行）、/loop（CLI 会话内重复 prompt 轮询）。
  • 可跨设备协作：Remote Control 从手机继续会话、Dispatch、claude --teleport（把 web/iOS 任务拉到终端）、/desktop（把终端会话交给 Desktop app）、Slack 中 @Claude。

怎么配置 / 用法 ​

Terminal 安装方式（择一）：

Native Install（推荐）：

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
powershell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
batch
:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew（不自动更新，需 brew upgrade claude-code）：

bash
brew install --cask claude-code

WinGet（不自动更新，需 winget upgrade Anthropic.ClaudeCode）：

powershell
winget install Anthropic.ClaudeCode

也可用 apt、dnf、apk（Debian、Fedora、RHEL、Alpine）安装。

安装后在任意项目启动：

bash
cd your-project
claude

首次使用会提示登录。VS Code/Cursor 可在 Extensions 搜索 "Claude Code" 安装。

什么时候用 ​

  • 第一次了解 Claude Code 是什么、能做什么、有哪些运行界面时。
  • 决定在哪个环境（Terminal / VS Code / JetBrains / Desktop / Web）使用并完成安装上手时。
  • 想知道某类任务（自动化琐事、写代码修 bug、git/PR、MCP 集成、定制、agent 团队、CLI 脚本化、定时任务、跨设备）该用哪个能力或文档入口时。
  • 需要从概览页跳转到 Quickstart、memory、common workflows、settings 等深入文档时。

限制 / 坑 ​

  • 大多数界面需要 Claude subscription 或 Anthropic Console 账户；Terminal CLI 与 VS Code 也支持第三方 providers。Desktop app 需要付费订阅。
  • Native installations 会后台自动更新；Homebrew、WinGet 安装不自动更新，需手动升级。
  • native Windows 上推荐安装 Git for Windows 以便使用 Bash tool；未装则改用 PowerShell 作为 shell tool（WSL 无需 Git for Windows）。

硬事实速查（11 条） ​

  • Native 安装命令：macOS/Linux/WSL 用 curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell 用 irm https://claude.ai/install.ps1 | iex。
  • Homebrew：brew install --cask claude-code；有两个 cask——claude-code（stable，通常落后约一周）与 claude-code@latest（latest，最新即发）。
  • WinGet：winget install Anthropic.ClaudeCode；升级用 winget upgrade Anthropic.ClaudeCode。
  • 启动命令为 claude（在项目目录内运行）；首次使用会提示登录。
  • 管道用法示例：tail -200 app.log | claude -p "Slack me if you see any anomalies"，-p 为非交互 prompt 模式。
  • CLAUDE.md 放在项目根目录，Claude Code 在每次会话开始时读取，用于设定规范与架构决策。
  • skills 封装可复用工作流，示例命令如 /review-pr、/deploy-staging；定时相关命令 /schedule、/loop、/desktop。
  • claude --teleport 可把 web/iOS 上启动的任务拉到终端继续。
  • Web 入口：claude.ai/code；VS Code 扩展可用 Command Palette 选 Open in New Tab。
  • JetBrains 插件支持 IntelliJ IDEA、PyCharm、WebStorm 等，从 JetBrains Marketplace 安装后重启 IDE。
  • 各界面共享同一底层引擎，CLAUDE.md、settings、MCP servers 跨界面通用。

官方出处：https://code.claude.com/docs/en/overview