Home
avatar

麒麟剑

Claude Code实战教程(1):AI编程新纪元——为什么你的终端里住进了一个超级程序员?

《从零开始的 Claude Code 实战系列教程》第 1 篇 · 公众号「麒麟剑的AI自动化Lab」连载

Coding workspace with AI assistant ▲ 现代编程工作流: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 是一个能直接动手干活的编程同事。

Developer working with AI terminal ▲ 终端里的 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 Pro20/月)或Max20/月)或 **Max**(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 | 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          # 稳定版
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。

Installing software via terminal ▲ 通过终端安装工具是现代开发者的标准操作


四、第一次启动:登录与认证

打开终端,进入你的项目目录(或任意目录),输入:

claude

首次启动会提示登录。按提示在浏览器中完成认证即可。支持三种登录方式:

  1. Claude 订阅账号(最推荐,直接点击登录)
  2. API Key:设置环境变量 ANTHROPIC_API_KEY,跳过登录提示
  3. 企业网关:如果公司部署了 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 不会一次性把所有文件塞进上下文,而是根据问题按需读取相关文件。这意味着即使是大项目,启动速度也很快。

Reading code on screen ▲ Claude Code 会智能地按需读取代码,而不是加载整个项目


六、第一次动手:让 Claude 写代码

试试让 Claude 做一些实际的事情:

在项目根目录创建一个 hello.py,包含一个 greet(name) 函数,输出 "Hello, {name}!"

Claude 会:

  1. 搜索项目结构
  2. 创建文件
  3. 显示 diff(变更预览)
  4. 等待你确认

在终端中你会看到类似:

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 会自动:

  1. 添加类型注解
  2. 创建测试文件
  3. 编写测试用例
  4. 运行测试验证

Code being written ▲ 看着 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 的基础知识。下一步建议:

  1. 实践练习:找一个你自己的项目,尝试用 Claude Code 帮助开发
  2. 学习提示词技巧:下一章我们将讲解如何让 Claude 一次性做对
  3. 配置 CLAUDE.md:让你的 AI 助手真正理解你的项目

延伸阅读


下期预告(第 2 篇):交互式会话的36种开场白——掌握让AI一次性做对的黄金法则

关注本系列,从入门到专家,系统掌握 Claude Code 的全部技能。

Claude Code AI编程 教程 入门 Anthropic 终端 Agentic Coding