前置知识

阅读本文前,建议先了解:

一、什么是 Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程 CLI 工具,可直接在终端中与 Claude 协作完成软件工程任务。它是一个代理框架(Agent Framework),将语言模型转变为能够自主编码的智能代理。

┌─────────────────────────────────────────┐
│           Claude Code 代理框架           │
├─────────────────────────────────────────┤
│                                         │
│   ┌─────────────┐      ┌─────────────┐  │
│   │   模型       │  +   │   工具      │  │
│   │  (推理)   │      │  (行动)   │  │
│   └─────────────┘      └─────────────┘  │
│            ↓                  ↓          │
│         ┌─────────────────────────┐     │
│         │     代理循环             │     │
│         │ 收集 → 行动 → 验证       │     │
│         └─────────────────────────┘     │
│                                         │
└─────────────────────────────────────────┘

简单来说:Claude 不仅是回答问题的”超级读者”,还能成为帮你写代码的”超级开发者”。


二、代理循环

Claude Code 的核心是代理循环(Agent Loop)——一个持续迭代的工作流程:

┌──────────────────────────────────────────────────────────┐
│                     代理循环                              │
├──────────────────────────────────────────────────────────┤
│                                                          │
│    ┌─────────┐    ┌─────────┐    ┌─────────┐           │
│    │ 收集    │ →  │  行动   │ →  │ 验证    │           │
│    │ Context │    │  Tool   │    │ Result  │           │
│    └─────────┘    └─────────┘    └────┬────┘           │
│         ↑                             │                  │
│         └─────────────────────────────┘                  │
│                      (循环直到完成)                        │
└──────────────────────────────────────────────────────────┘
阶段说明示例
收集读取项目文件、了解上下文读取代码、搜索相关文件
行动使用工具执行任务编写代码、运行命令
验证检查结果是否正确运行测试、检查输出

三、内置核心工具

Claude 内置了一系列核心工具,帮你完成各种编程任务:

3.1 工具能力一览

类别Claude 可以做什么工具示例
文件操作读取文件、编辑代码、创建新文件、重命名和组织Read、Edit、Write、Glob
搜索按模式查找文件、使用正则表达式搜索内容Glob、Grep
执行运行 shell 命令、启动服务器、运行测试、使用 gitBash
网络搜索网络、获取文档、查找错误消息WebFetch
代码智能查看类型错误、跳转到定义、查找引用需要代码智能插件

3.2 内置工具详情

┌─────────────────────────────────────────┐
│              Claude 内置工具            │
├─────────────────────────────────────────┤
│ Read      - 读取文件内容                │
│ Edit      - 编辑现有文件                │
│ Write     - 创建新文件                  │
│ Glob      - 按模式搜索文件(如 *.py)   │
│ Grep      - 搜索文件内容(正则表达式)  │
│ Bash      - 执行 shell 命令             │
│ WebFetch  - 获取网页内容                │
└─────────────────────────────────────────┘

四、安装方式

4.1 原生安装(推荐)

macOS / Linux / WSL:

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

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

4.2 包管理器安装

系统命令
macOS (Homebrew)brew install --cask claude-code
Windows (WinGet)winget install Anthropic.ClaudeCode

4.3 登录认证

# 登录(会打开浏览器引导认证)
claude auth login
 
# 查看认证状态
claude auth status
 
# 登出
claude auth logout

五、Claude 可以访问什么

5.1 访问范围

当你在目录中运行 claude 时,Claude 可以访问:

┌─────────────────────────────────────────┐
│          Claude 的访问范围               │
├─────────────────────────────────────────┤
│ ✅ 项目文件(目录和子目录)               │
│ ✅ 终端命令(构建工具、git、包管理器)    │
│ ✅ Git 状态(分支、未提交变更、历史)     │
│ ✅ CLAUDE.md(项目指令)                 │
│ ✅ 自动记忆(MEMORY.md)                 │
│ ✅ 配置的扩展(MCP、Skills、Subagents)  │
└─────────────────────────────────────────┘

5.2 与内联代码助手的区别

特性Claude Code内联代码助手
视野范围整个项目当前文件
执行能力可运行命令仅建议代码
协调编辑跨文件修改单文件修改
验证能力自动运行测试无法验证

六、执行环境

环境代码运行位置用例
本地你的机器默认,完全访问
Anthropic 管理的虚拟机卸载任务、远程仓库
远程控制你的机器,从浏览器控制使用 Web UI

七、界面类型

┌─────────────────────────────────────────┐
│           可用界面                      │
├─────────────────────────────────────────┤
│  终端(CLI) - 默认界面,完全功能        │
│  VS Code 扩展 - 内联 diff、@引用文件     │
│  JetBrains 插件 - IntelliJ/PyCharm 等  │
│  桌面应用 - 可视化 diff 审查、多会话     │
│  claude.ai/code - Web 界面,1M token     │
│  Slack - 团队协作                       │
│  CI/CD - GitHub Actions 集成            │
└─────────────────────────────────────────┘

八、总结

核心要点

  1. 代理循环:收集上下文 → 采取行动 → 验证结果的循环
  2. 模型 + 工具:模型负责推理,工具负责行动
  3. 项目视野:可以看到整个项目,进行跨文件协调
  4. 安装简单:一行命令安装,支持多种认证方式
  5. 安全机制:检查点撤销 + 权限控制双重保障

下一站

掌握基础概念后,前往 02-Claude Code 基础使用 学习如何安装配置、开始会话和使用快捷命令。


延伸阅读