Claude Code实战教程(1):AI编程新纪元——为什么你的终端里住进了一个超级程序员?
《从零开始的 Claude Code 实战系列教程》第 1 篇 · 公众号「麒麟剑的AI自动化Lab」连载
▲ 现代编程工作流:AI 正在改变我们编写代码的方式
一、先搞清楚一件事:Claude Code 到底是什么?
如果你已经用过 ChatGPT 或 Claude 聊天,但你从未在终端里看到过这样的对话:
> 帮我把这个按钮的颜色改成蓝色
[代码自动修改]
Apply these changes? (Y/n)那恭喜你,你即将进入一个全新的编程世界。
网上关于 Claude 的工具有很多,名字也很相似。我们先来一张总图,彻底理清关系:
┌─────────────────────────────────────────────────────────────────┐
│ Claude 全家桶 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Claude.ai │ │ Claude Code │ │ Claude API │ │
│ │ (网页聊天) │ │ (编程助手) │ │ (开发者接口) │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ │ ┌───────┴────────┐ │ │
│ │ │ Claude Code │ │ │
│ │ │ 四种运行界面 │ │ │
│ │ └───────┬────────┘ │ │
│ │ │ │ │
│ ┌▼────┐ ┌─────▼───┐ ┌─────▼────┐ │
│ │CLI │ │Desktop │ │ VS Code │ │
│ │终端 │ │桌面应用 │ │ 插件 │ │
│ └─────┘ └─────────┘ └──────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 共同的基础能力(共享账户和订阅) │ │
│ │ 读写文件 · 执行命令 · 理解代码 · MCP · Skills · Hooks │ │
│ └──────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘Claude.ai(网页聊天) vs Claude Code(编程助手)
| 特性 | Claude.ai(网页) | Claude Code(终端/IDE) |
|---|---|---|
| 能否读写你的本地文件 | ❌ 不能 | ✅ 可以 |
| 能否执行终端命令 | ❌ 不能 | ✅ 可以 |
| 能否理解整个代码库 | ❌ 只能看到粘贴的内容 | ✅ 自动读取项目文件 |
| 适合场景 | 写作、分析、一般问答 | 写代码、重构、调试、DevOps |
| 是否需要手动复制粘贴 | 是 | 否,Claude 自己读 |
| 能否连续迭代修改 | 有限 | 无限,直到你满意为止 |
一句话总结:Claude.ai 是一个聪明的聊天对象,Claude Code 是一个能直接动手干活的编程同事。
▲ 终端里的 AI 编程助手,正在帮你处理复杂的代码任务
二、为什么你需要 Claude Code?
想象一下这个场景:
场景 1:修复一个难找的 bug
传统方式:
1. 看到报错信息
2. 搜索错误关键词
3. 浏览相关文档
4. 逐行检查代码
5. 尝试修复
6. 测试验证
Claude Code 方式:
你:这个 bug 是什么原因导致的?
Claude:让我分析一下...找到了,第 42 行的空指针问题
[自动修复代码]
已修复,这是变更内容...场景 2:理解一个新项目
传统方式:
1. 阅读 README
2. 浏览目录结构
3. 逐个打开核心文件
4. 画图理解依赖关系
5. 可能需要几天才能理解整体架构
Claude Code 方式:
你:这个项目是做什么的?核心架构是什么?
Claude:这是一个电商后端服务,使用 NestJS 构建...
主要模块包括:用户认证、商品管理、订单处理...
[生成架构图]场景 3:快速原型开发
传统方式:
1. 设计数据库 schema
2. 编写 API 代码
3. 实现前端页面
4. 联调测试
5. 部署上线
→ 需要数天甚至数周
Claude Code 方式:
你:帮我创建一个用户管理系统,包含登录、注册、权限控制
Claude:[自动生成完整项目结构]
[实现所有功能]
[写好测试]
→ 几小时完成三、环境要求与安装
需要的账号
Claude Code 需要以下任意一种订阅:
- Claude Pro(100/月)
- Claude Team / Enterprise
- Claude Console(API 付费额度)
- 或通过云提供商访问:Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry
安装步骤
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
irm https://claude.ai/install.ps1 | iexWindows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew(macOS)
brew install --cask claude-code # 稳定版
brew install --cask claude-code@latest # 最新版(不自动更新)验证安装
claude --version
# 输出类似:Claude Code v2.1.x (Claude)Windows 用户注意:建议安装 Git for Windows,Claude Code 会使用 Git Bash 作为 shell。如果没有 Git,会自动降级使用 PowerShell。
▲ 通过终端安装工具是现代开发者的标准操作
四、第一次启动:登录与认证
打开终端,进入你的项目目录(或任意目录),输入:
claude首次启动会提示登录。按提示在浏览器中完成认证即可。支持三种登录方式:
- Claude 订阅账号(最推荐,直接点击登录)
- API Key:设置环境变量
ANTHROPIC_API_KEY,跳过登录提示 - 企业网关:如果公司部署了 Claude Apps Gateway,通过 SSO 登录
登录后,你会看到类似这样的界面:
Claude Code (v2.1.x)
Model: claude-sonnet-5
Directory: ~/my-project
Working tree: clean
Type /help for commands, @file or @dir to reference, Ctrl+C to interrupt这个界面看起来有点单调,但它背后连接着一个强大的 AI 大脑。
五、你的第一个对话:让 Claude 认识你的项目
现在,试着输入:
这个项目是做什么的?Claude 会分析你的代码库并给出总结。你也可以问:
这个项目用了哪些技术栈?主入口文件在哪里?给我讲一下整体目录结构核心原理:Claude Code 不会一次性把所有文件塞进上下文,而是根据问题按需读取相关文件。这意味着即使是大项目,启动速度也很快。
▲ Claude Code 会智能地按需读取代码,而不是加载整个项目
六、第一次动手:让 Claude 写代码
试试让 Claude 做一些实际的事情:
在项目根目录创建一个 hello.py,包含一个 greet(name) 函数,输出 "Hello, {name}!"Claude 会:
- 搜索项目结构
- 创建文件
- 显示 diff(变更预览)
- 等待你确认
在终端中你会看到类似:
I'll create a hello.py file with a greet function.
@@ -0,0 +1,5 @@
+def greet(name):
+ return f"Hello, {name}!"
+
+if __name__ == "__main__":
+ print(greet("World"))
Apply these changes? (Y/n)输入 Y 确认,Claude 就创建好了文件。
再试一个更有挑战的任务:
给 greet 函数加上类型注解和单元测试Claude 会自动:
- 添加类型注解
- 创建测试文件
- 编写测试用例
- 运行测试验证
▲ 看着 AI 一步步完善代码,感觉就像有一个高级程序员在你身边
七、权限模式:让 Claude 知道它有多大权限
Claude Code 有三种权限模式,按 Shift+Tab 可以在它们之间切换:
🔒 Manual(手动模式)
每次编辑文件或执行命令前,都会询问你是否同意。适合学习阶段,让你清楚了解 Claude 在做什么。
Claude: 我将修改 src/auth.ts 中的 login 函数
[显示 diff]
Apply these changes? (Y/n)🟢 Auto(自动模式)
内置的分类器自动判断每个操作是否安全,大部分操作无需确认。Pro/Max/Team 订阅默认开启。适合熟练用户。
Claude: 正在修改 login 函数...
✓ 已应用修改
✓ 已添加单元测试
✓ 测试通过⚠️ Dont Ask(不询问模式)
所有操作自动执行,不再提示。仅在充分信任 AI 时使用,风险较高。
如何切换权限模式
Shift+Tab # 在 Manual ↔ Auto ↔ Dont Ask 之间循环
Shift+Tab Shift+Tab # 反向循环建议初学者始终使用 Manual 模式,熟悉后再切换到 Auto。
八、常用快捷键速查表
| 快捷键 | 功能 | 使用场景 |
|---|---|---|
↑ / ↓ | 浏览历史命令 | 回忆之前输入的命令 |
Tab | 补全命令 | 快速输入文件名或命令 |
Shift+Tab | 切换权限模式 | 在不同安全级别间切换 |
Ctrl+C | 中断当前操作 | 想让 Claude 停下来 |
Ctrl+D | 退出 Claude Code(按两次) | 结束工作 |
@ | 引用文件或目录 | 如 @src/auth.ts |
/ | 打开命令菜单 | 查看所有可用命令 |
Esc | 取消当前输入 | 回退到上一状态 |
九、退出与恢复会话
/exit # 退出 Claude Code
claude -c # 继续上一次的会话
claude -r # 选择之前的会话恢复每次会话都会有一个唯一的 ID,你可以在 / 命令菜单中查看所有历史会话。
这意味着你可以:
- 今天讨论一部分代码,明天接着聊
- 并行开多个会话,处理不同任务
- 随时回溯之前的对话,复习决策过程
十、本章小结
| 知识点 | 内容 |
|---|---|
| Claude Code 是什么 | 可以直接读写文件、执行命令的 Agentic 编程助手 |
| 与 Claude.ai 的区别 | 能动手干活,不只是聊天 |
| 安装方式 | curl 脚本 / brew / winget |
| 登录 | 浏览器 OAuth 或 API Key |
| 核心能力 | 理解代码库、编辑文件、运行命令 |
| 权限模式 | Manual → Auto → Dont Ask |
| 第一次对话 | 直接说自然语言,Claude 按需读文件 |
十一、接下来做什么?
你现在已经掌握了 Claude Code 的基础知识。下一步建议:
- 实践练习:找一个你自己的项目,尝试用 Claude Code 帮助开发
- 学习提示词技巧:下一章我们将讲解如何让 Claude 一次性做对
- 配置 CLAUDE.md:让你的 AI 助手真正理解你的项目
延伸阅读
- 官方文档:https://code.claude.com/docs/en/quickstart
- CLI 参考手册:https://code.claude.com/docs/en/cli-reference
- Claude Code 社区 Discord:https://www.anthropic.com/discord
- GitHub 上的 Claude Code Tips:https://github.com/ykdojo/claude-code-tips
下期预告(第 2 篇):交互式会话的36种开场白——掌握让AI一次性做对的黄金法则
关注本系列,从入门到专家,系统掌握 Claude Code 的全部技能。