Claude Code 入门：你的终端 AI 代理

30 秒安装，5 分钟上手，理解 Claude Code 的核心概念

写在前面

最近在技术社区上看到一个问题：为什么那么多人对 AI 工具感兴趣，但真正用起来的没几个？

说实话，我也这样过。每次装完一个新工具，先是兴奋，然后看着复杂的配置文档陷入沉思……最后默默关掉，心想"算了，下次再说"。

所以这篇文章，我承诺：不堆术语，不讲废话，只说三件事——

Claude Code 是什么（以及不是什么）
怎么装（30 秒内搞定）
怎么用（5 分钟内见效）

读完这篇，你就能在终端里让 Claude Code 帮你干活了。

一、Claude Code 是什么？

1.1 它不是代码补全工具

很多人第一反应是："这不就是另一个 GitHub Copilot 吗？"

不是。

Copilot 模式：
你写一半代码 → Copilot 补全 → 你继续写

Claude Code 模式：
你描述需求 → Claude 理解 → Claude 写完 → Claude 测试 → Claude 提交

打个比方：

Copilot 像副驾驶，你开车它帮忙踩油门
Claude Code 像代驾，你告诉目的地，它全程开

这不是量变，是质变。

1.2 "代理"的本质

Claude Code 官方定位是 Agentic Coding Tool——代理编程工具。

什么是"代理"？

普通工具 vs 代理工具

举个例子：

普通 AI 工具：

你：帮我写一个读取 JSON 文件的函数

AI：好的，这是代码...
function readJson(path) { ... }

Claude Code：

你：帮我写一个读取 JSON 文件的函数

Claude Code：
1. 先看看你的项目结构
2. 发现你用的是 TypeScript
3. 写了一个符合你项目风格的函数
4. 顺便写了类型定义
5. 还写了个单元测试
6. 问你要不要我帮你提交

区别在哪？

它主动。它会自己去看、去理解、去决策。

1.3 核心能力一图看懂

Claude Code 的三大核心能力——感知、规划、执行——完美融合，形成真正的智能代理：

ClaudeCode终极AI核心能力-code-venn.png

记住这张图，后面所有内容都是围绕它展开的。

1.4 核心架构详解

ClaudeCode核心架构

架构从上到下分为5层：

层级	组件	说明
输入层	用户输入	你说的话，如"帮我重构这个函数"
理解层	Claude理解	结合CLAUDE.md和项目文件理解意图
决策层	Claude决策	决定读哪些文件、执行什么命令、修改什么代码
工具层	内置工具	Read、Edit、Write、Bash等
扩展层	可扩展能力	Skills、Hooks、MCP（后续文章详解）

二、安装：30 秒搞定

2.1 前置条件

你需要：

Claude 订阅（Pro、Max、Teams 或 Enterprise）
终端（macOS、Linux、Windows 都行）

就这两样。

2.2 安装命令

macOS / Linux / WSL：

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

Windows PowerShell：

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

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew（macOS 推荐）：

brew install --cask claude-code

WinGet（Windows 推荐）：

winget install Anthropic.ClaudeCode

2.3 首次启动

claude

第一次启动会提示登录，按指引操作即可。

安装完成。 真的就这么简单。

三、5 分钟快速上手

3.1 第一个命令：让它认识你的项目

cd /path/to/your/project
claude

然后输入：

> 帮我分析一下这个项目的结构

Claude 会：

扫描项目目录
读取关键文件（README、package.json 等）
给你一个项目概览

效果：相当于有个新同事快速入职，你不用从头解释项目。

3.2 第二个命令：让它帮你写代码

> 在 src/utils 目录下创建一个日期格式化工具函数

Claude 会：

看看项目用的是什么语言
参考现有的代码风格
创建符合规范的文件

效果：不用管细节，说出需求就行。

3.3 第三个命令：让它帮你重构

> src/auth/login.ts 这个文件太长了，帮我拆分一下

Claude 会：

分析文件结构
识别可拆分的模块
创建新文件
更新引用

效果：重构这种累活，交给它。

3.4 第四个命令：让它帮你查 Bug

> 我遇到了一个错误：TypeError: Cannot read property 'id' of undefined
  帮我找找是哪里出的问题

Claude 会：

搜索相关代码
分析可能的原因
给出修复建议

效果：不用自己一行行翻代码。

四、核心概念：理解这些就够了

4.1 CLAUDE.md：项目的"说明书"

Claude Code 启动时会自动读取项目根目录的 CLAUDE.md 文件，把它当作项目的"说明书"。

示例 CLAUDE.md：

# 项目说明

## 技术栈
- React 18 + TypeScript
- TailwindCSS
- Vite

## 代码规范
- 使用 2 空格缩进
- 组件文件用 PascalCase 命名
- 工具函数用 camelCase 命名

## 常用命令
- `npm run dev` 启动开发服务器
- `npm run build` 构建生产版本
- `npm test` 运行测试

## 注意事项
- 不要直接修改 src/generated 目录
- API 调用都要经过 src/api/client.ts

为什么重要？

没有这个文件，Claude 只能"猜测"你的项目规范。
有了这个文件，Claude 就能"按规矩办事"。

4.2 内置工具

Claude Code 内置了几个核心工具：

工具	作用	例子
Read	读取文件内容	看代码、看配置
Edit	编辑现有文件	修改代码、修 bug
Write	创建新文件	新建组件、新建配置
Bash	执行 shell 命令	跑测试、安装依赖
Grep	搜索文件内容	找函数定义、找引用
Glob	搜索文件名	找所有 .ts 文件

你不需要手动调用这些工具，Claude 会自己决定用什么。

4.3 工作模式

Claude Code 有两种工作模式：

1. 交互模式（默认）

你说话 → Claude 做事 → Claude 问你确认 → 继续

2. 自动模式（--dangerously-skip-permissions）

你说话 → Claude 做完 → 结果

建议新手用交互模式，等熟悉了再用自动模式。

五、常见问题

Q1：Claude Code 和 Cursor 有什么区别？

对比项	Claude Code	Cursor
运行环境	终端	IDE
工作方式	对话驱动	内嵌编辑器
自定义能力	Skills、Hooks、MCP	Rules、Modes
适合场景	复杂任务、自动化流程	日常编码

简单说：Cursor 更适合写代码，Claude Code 更适合"让代码自己写"。

Q2：会不会把我的代码改坏？

不会乱改。默认情况下：

每次修改都会让你确认
可以随时撤销
支持显示 diff

建议：重要项目先开个新分支，放心让 Claude 折腾。

Q3：能处理多大的项目？

取决于上下文窗口。Claude 会智能选择读取哪些文件，不会一次性加载整个项目。

实践建议：

小项目（<100 文件）：体验很好
中项目（100-1000 文件）：大部分情况 OK
大项目（>1000 文件）：配合 CLAUDE.md 引导

Q4：支持哪些编程语言？

主流语言都支持：

JavaScript / TypeScript
Python
Go
Rust
Java
C / C++
等等……

五、效果验证

学完本篇，你应该能够完成以下任务：

验证清单

成功安装 Claude Code
完成首次登录
在项目目录中启动 Claude Code
让 Claude 分析一个项目的结构
让 Claude 创建一个简单文件

动手练习（5分钟）

任务 1：安装验证

# 检查 Claude Code 是否安装成功
claude --version

如果显示版本号，安装成功。

任务 2：首次对话

# 进入任意项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

然后输入：

> 你好，请介绍一下你自己

Claude 会告诉你它的能力。

任务 3：项目分析

> 分析这个项目的结构，告诉我这是什么类型的项目

任务 4：简单任务

> 创建一个 hello.txt 文件，写入「Hello from Claude Code！」

如果这四个任务都完成，你已经入门了！

你现在理解的「代理」vs「补全」

回答这个问题：如果让 Claude Code 帮你重构一个函数，它会怎么做？

如果你能说出「它会先读取文件，理解函数，搜索调用处，修改代码，运行测试」这样的答案，说明你真正理解了「代理」的本质。

六、总结与下期预告

本文要点

Claude Code 是代理，不是补全：它会自己理解、决策、执行
安装简单：一条命令，30 秒搞定
上手容易：会说话就会用
CLAUDE.md 是关键：让 Claude 懂你的项目

下期预告

下一篇，我们会深入 Claude Code 的内置工具，让我们抽丝剥笋，看看这些工具到底是怎么工作的：

Read 怎么读得更聪明
Edit 怎么改得更精准
Bash 怎么执行得更安全
Grep/Glob 怎么搜得更快

上代码验证一下，你会发现这些工具的组合使用，能让你的开发效率提升好几倍。

如果你在安装或使用过程中遇到问题，欢迎在评论区分享你的经验，我们一起交流。

下期见！

附录：常用命令速查

命令	作用
`claude`	启动交互式会话
`claude -p "你的问题"`	单次提问模式
`claude --help`	查看帮助
`/help`	会话内查看帮助
`/compact`	压缩对话历史
`/clear`	清空对话
`/exit`	退出 Claude Code

本篇属于 Claude Code 提效系列第 1 篇
下期预告：Claude Code 核心工具全解析

创建时间：2026-02-14
参考文档：Claude Code 官方文档