Claude code入门保姆级教程

Islucas2026-04-05 21:25

Claude code入门保姆级教程

Claude Code 学习笔记

一、Claude Code介绍

1、Vibe Coding

Vibe Coding，直译为"氛围编程"或"沉浸式编程"，是一种以结果为导向的全新编程方式。它的核心理念是：人类只负责提出需求和审核结果，代码的实现细节全部交给 AI 完成。在这种模式下，开发者通过自然语言、示例或图形描述功能需求，AI 工具（如 ChatGPT、Cursor、Claude Code 等）会自动生成代码并运行，用户只需根据结果进行反馈和调整，直到符合预期为止。

2、Claude Code 概述

Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

价格参考：1美元 ≈ 6.88人民币

  • $20/月 ≈ 140元
  • $100/月 ≈ 700元
  • ClaudeCode只是一个工具。真正的"大脑"是里面的模型。
  • 模型是可以替换的

二、Claude Code安装

1、安装Git

安装步骤：

  1. 下载完成后，双击运行安装
  2. 傻瓜式安装，直接点击下一步即可
  3. 根据需要修改安装路径

验证安装：

bash 复制代码 
# 查看git是否安装成功，如果能够显示版本号，则说明安装成功
git -v

为什么需要安装Git？

Claude Code 是一个强大的 AI 编程工具，支持在 Windows 系统上运行，但其运行环境依赖于 Git Bash 提供的功能。Git Bash 是 Git for Windows 提供的一个模拟类 Unix 的命令行工具。它为 Claude Code 提供了必要的终端环境，支持执行相关命令。

Git 本身是一个版本控制工具，Claude Code 可以利用 Git 的功能进行代码版本管理和协作开发，尤其是在需要与团队共享代码或管理项目历史时。

2、安装Node

注意事项：如果你是新安装，直接安装最新版本。如果以前安装过，检查一下版本。ClaudeCode毕竟是一个新出来的工具，Node版本如果太老，无法兼容。推荐20+LTS以上版本。

安装步骤：傻瓜式安装，不断点击"下一步"就可以。

验证安装：

bash 复制代码 
# 查看Node是否安装成功
node -v

为什么需要安装Node？

NPM 是 Node.js 自带的包管理工具，因此，通常你只需安装 Node.js，NPM 就会自动安装在系统中。

NPM 允许开发者轻松地下载、安装、共享、管理项目的依赖库和工具。ClaudeCode就是npm里面的一个包。

3、Claude Code安装

使用管理员运行CMD窗口：

bash 复制代码 
# 设置阿里云镜像加速
npm config set registry https://registry.npmmirror.com

# 使用npm安装Claude Code
npm install -g @anthropic-ai/claude-code

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

# 执行启动命令
claude

国内使用配置：

直接执行 claude 会发现报错。这是因为ClaudeCode工具会校验位置位置。国内是无法使用的，但是我们可以通过修改配置，来绕过这个校验。

找到C盘下的json配置文件，路径：C:\Users\<username>\.claude.json

添加以下内容：

json 复制代码 
"hasCompletedOnboarding": true,

注意：ClaudeCode可以正常启动后，自带的大模型在国内无法直接使用。可以接入国产的大模型（如阿里千问）用于演示教学。

4、获取阿里千问或KIMI的key

步骤：

  1. 支付宝扫码登录
  2. 新用户首次开通后，有100w的免费token使用额度（限时3个月）
  3. 建议先关闭"用完即停"，以免超出额度扣费
  4. 选择秘钥管理，创建一个API key
  5. 复制保存好key

5、配置模型（推荐：使用 cc switch 工具）

推荐使用 cc switch 工具管理多模型配置，特别适合长期使用多个模型（千问、DeepSeek、Claude 官方等）的用户。

方式一：使用 cc switch（推荐）

安装

bash 复制代码 
npm install -g claude-code-switch


**配置 API Key**
```bash
# 编辑配置文件
notepad %USERPROFILE%\.ccm_config

在配置文件中添加各模型的 API Key：

ini 复制代码 
# 阿里千问（ DashScope ）
QWEN_API_KEY=sk-your-dashscope-api-key

# 其他可选模型
DEEPSEEK_API_KEY=sk-your-deepseek-key
KIMI_API_KEY=your-kimi-key
GLM_API_KEY=your-glm-key
CLAUDE_API_KEY=your-claude-key

切换模型使用

bash 复制代码 
# 切换到阿里千问
ccm qwen

# 切换到其他模型
ccm deepseek    # DeepSeek
ccm glm         # 智谱GLM
ccm kimi        # Moonshot Kimi
ccm claude      # Claude 官方

github安装（1-2）

  • 下载好傻瓜式安装
  • 选择模型


    仅填写API即可
  • 成功后，在命令行输入 claude 进入，选择模型即可正常对话（/model）
方式二：手动配置环境变量（备选）

如果不使用 cc switch，可以手动设置环境变量：

bash 复制代码 
# YOUR_DASHSCOPE_API_KEY 需要替换成你自己的key
setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"
setx ANTHROPIC_MODEL "qwen3.5-plus"

新开一个窗口，查看参数是否设置成功：

bash 复制代码 
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

对比两种方式：

方式 优点 适用场景
cc switch 一键切换多模型，配置集中管理 长期使用多个模型
手动 setx 系统原生，无需额外工具 临时试用单个模型

设置完成后启动Claude，即可进行对话。

三、Claude Code快速入门

1、Claude Code基础操作介绍

Claude Code 的输入框不是纯聊天框，而是一个：

AI + 编辑器 + 命令调度器的融合终端

操作命令

/ 是 Claude Code 中触发内置命令工具的核心符号，类似终端命令行的指令前缀，用于告诉 Claude 执行特定操作而非单纯生成文本。

核心用途：调用内置功能（如代码生成、文件操作、环境执行、插件调用等）。

/ 后紧跟命令关键词，空格后接参数（如文件名、执行命令、修复目标等），是 Claude Code 区分自然语言对话 和代码操作指令的关键。

输入 / 会弹出命令列表：

命令 介绍
/help 显示所有可用的斜杠命令、快捷键以及帮助文档的入口
/init 在项目根目录初始化生成一个 CLAUDE.md 文件。这个文件是 AI 的"长期记忆"，你可以在这里记录项目规范、常用命令等
/clear 清空当前会话的对话历史，重置上下文。当你切换任务或感觉 AI 开始"忘记"早期指令时使用
/compact 智能压缩当前对话历史，用一个精炼的摘要代替冗长的对话，可释放 50%-80% 的 Token 空间，同时保留关键信息
/cost 实时显示当前会话消耗的 Token 数量和预估费用，帮助你控制预算
/context 查看当前上下文窗口的详细状态，包括已加载的文件和 Token 占用比例
/model 在当前会话中动态切换 AI 模型，而无需重启 Claude
/doctor 运行系统诊断，检查 Node.js 版本、API 连接、文件权限等，是遇到问题时的首选命令
/config 打开交互式配置菜单，可以修改主题、权限、默认模型等全局设置
上下文注入

@ 后面跟文件名，会主动联想

bash 复制代码 
# 引用单文件
@main.py 帮我检查 bug

# 引用多文件
@main.py @main2.py 这两个是否有重复逻辑？

# 引用错误日志：
@npm-debug.log 找出失败原因
Bash 命令
bash 复制代码 
# 显示当前工作目录
! pwd

# 创建新目录
mkdir dirname

# 列举目录文件
! ls -la

2、Claude Code功能演示

需求：写一个代码，从1加到100。

java 复制代码 
public class Sum1To100 {
    public static void main(String[] args) {
        int sum = 0;
        for (int i = 1; i <= 100; i++) {
            sum += i;
        }
        System.out.println("1 加到 100 的和为：" + sum);
    }
}

3、Claude Code 交互模式

模式切换 ：按下 Shift + Tab 切换三种模式

普通模式：【? for shortcuts】

Claude Code 的默认安全模式

使用场景：

  • 看不懂现有代码
  • 刚接手一个新项目
  • 想定位 Bug 的原因，但还没想好怎么修
  • 想确认某段逻辑是否合理

模式特点：

  • Claude 可以读取代码
  • 可以进行分析、解释、推理
  • 不会修改任何文件
  • 不会执行任何 Shell 命令

一位经验丰富、但双手放在背后的高级工程师。

规划模式：【Plan】

Plan 模式是 Claude Code 中最像架构师思维的模式。

使用场景 ：

当你面对的是复杂或影响范围较大的改动时，应该使用 Plan 模式，例如：

  • 新增一个核心模块
  • 重构已有接口或业务流程
  • 引入新技术（缓存、中间件、鉴权方案等）
  • 涉及多个文件、多个层级的修改

模式特点：

  • Claude 不会直接改代码
  • 会先给出完整的实施方案
  • 通常以步骤列表（TODO List）的形式呈现
  • 你确认方案后，才进入 Edit 阶段执行

把先写代码变成先达成共识。

直接执行：【Edit】

Edit 模式是 Claude Code 真正动手的阶段。

使用场景 ：

当你已经明确知道：

  • 要改哪
  • 改成什么
  • 改动风险可控

此时就可以直接进入 Edit 模式。

模式特点：

  • Claude 会定位相关文件
  • 生成精确的 Diff（差异修改）
  • 可能会请求执行测试、构建等命令
  • 所有写入操作都需要你确认

4、Claude Code记忆系统

每次 Claude Code 会话结束，上下文就会清空。这个时候就需要我们的 Claude.md 文件了。

什么是 CLAUDE.md 文件

CLAUDE.md 是一个放在项目根目录的 Markdown 文件，Claude Code 在每次会话开始时都会自动读取。

CLAUDE.md 会成为 Claude 系统提示的一部分，使每次对话都能预先加载项目上下文，不再需要重复解释基本信息。

一份好的 CLAUDE.md 应该覆盖三个维度：

  • WHAT（是什么）：技术栈、项目结构，为 Claude 提供代码库的全局地图
  • WHY（为什么）：项目的目的，各模块的功能与定位
  • HOW（怎么做）：开发方式，例如使用 bun 而非 node，以及 Claude 如何验证改动是否正确

典型 CLAUDE.md 结构示例：

markdown 复制代码 
# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any，使用 unknown 替代

文件位置与层级：

复制代码 
your-project/
├── CLAUDE.md                  # 项目主记忆文件（团队共享）
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置（建议加入 .gitignore）
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置

Claude.md文件创建方式：

  • 手工创建：如果是空的项目，就可以手工创建
  • /init 命令自动创建：这个需要项目里面已经有代码

5、Claude Code会话管理

bash 复制代码 
# 压缩上下文，如果对话超长的话
/compact
![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/3467d2c6caf14af78b6e662a1c1d54fb.png)

# 清空对话
/clear

# 按 esc 可以暂停会话

# 继续最近的一次对话（快速恢复）
claude --continue
# 或使用简写
claude -c

# 显示历史对话列表并选择恢复。从当前文件的目录下恢复
claude --resume
# 或使用简写
claude -r

四、写在最后：关于AI思考

互联网目前针对AI的出现，有两种不同的看法

一部分人拥护AI，一部分人抵制AI，怎么看？

  • 要看待这个问题，要从一个词出发，"利益"，AI的出现，是否对自己的利益造成了影响。
  • 拥护AI的人，是享受到了AI带来的便利，或者说增加了自己的利益。
  • 抵制AI的人，是觉得AI会侵犯自己的利益。比如说取代自己的岗位，自己没有收入，失业，没法养活自己和家庭。

拥护AI的人是那部分？

  • 本身就从事AI这个行业领域的人，AI这个越火，受益越大。
  • 个人研发者，自媒体账号博主。个人研发者接单，一个人干所有的活，AI能帮助提效，自媒体博主，吃AI这个概念带来的红利。
  • 部分公司企业领导层，考虑降本增效。

抵制AI的人是那部分？

  • 抵制AI的人，主要还是担心自己的岗位，自己的工作，将来某天会被AI取代。也就是目前可能会被替代的，快递员，滴滴司机等。（萝卜快跑，顺丰无人送货车）

AI会取代程序员吗？

  • 会给程序员这个行业带来影响，减少岗位数量，但是不会取代程序员。
  • AI是怎么提效的，时间上可能并没有提效。一个任务单，无论是否引入AI，可能工作量都是10小时。
  • AI出现的理想情况下，程序员解放双手，让AI编码，然后自己在AI编码的时候，去喝喝咖啡，悠闲一下。但是资本是不允许这种情况出现。裁员。裁员后，每个人的工作量变多。所以使用AI后并没有变得更轻松。
  • 就目前来看，使用AI编码的前提时，你本人需要有编码能力。AI写的代码也是有Bug的，如果你完全不懂代码，出现生产问题，怎么解决就是一个大隐患，尤其是涉及到钱的问题。
  • 程序员行业，使用AI开发，不会完全使用，老项目重构，性能优化的价值太低。做的好是AI的功能，做的不好程序员背锅。被投诉，绩效背C。

AI是不是泡沫

  • AI是不是泡沫，不知道，泡沫只有在它破了那一刻你才知道他是泡沫，没破之前都是商机，都是机会。

对未来怎么看

  • AI对一些岗位会有影响，但是还替代不了。比如心理咨询行业，精神分析流派。移情，投射。AI不具备这个。如果没有这两个工具，精神分析这门学科都不完整。
  • 夜间开车。大灯的距离只能看到50米，但是能使我们到达千里之外的目的地。未来会怎么样，不知道，该吃吃，该喝喝，锻炼身体。
  • 理性看待AI。不用盲目吹捧，也不用盲目抵制，如果你目前的工作能够用AI提效，试试也无妨。
相关推荐
萝卜白菜。3 小时前
TongWeb7.0相同的类指明加载顺序
开发语言·python·pycharm
赵钰老师3 小时前
【ADCIRC】基于“python+”潮汐、风驱动循环、风暴潮等海洋水动力模拟实践技术应用
python·信息可视化·数据分析
爬山算法4 小时前
MongoDB（80）如何在MongoDB中使用多文档事务？
数据库·python·mongodb
YuanDaima20484 小时前
基于 LangChain 1.0 的检索增强生成（RAG）实战
人工智能·笔记·python·langchain·个人开发·langgraph
RopenYuan5 小时前
FastAPI -API Router的应用
前端·网络·python
听风吹等浪起5 小时前
用Python和Pygame从零实现坦克大战
开发语言·python·pygame
书到用时方恨少!5 小时前
Python Pandas 使用指南：数据分析的瑞士军刀
python·数据分析·pandas
智算菩萨6 小时前
【Pygame】第8章 文字渲染与字体系统（支持中文字体）
开发语言·python·pygame
:mnong6 小时前
全图纸语义理解升级分析
python·openvino·paddleocr·qt6.3·paddleocr-vl
热门推荐
01GitHub 镜像站点02Qwen3.5-Omni与Qwen3.6模型全面解析（含测评/案例/使用教程）03VMware Workstation Pro 17 虚拟机完整安装教程（2026最新）042026年3月AI领域大事件：DeepSeek引领开源风暴05OpenClaw 请求超时 llm request timed out 怎么解决？3 种方案实测，附完整排查流程06【技术干货】Gemma 4 上手深度指南：本地多模态大模型的新基线07Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services08UV安装并设置国内源09AI 编程效率翻倍：Superpowers Skills 上手清单 + 完整指南10纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！