Skip to content

🌱 初级教程 - 入门篇

适合:完全没有使用过 Claude Code 的新手


⚠️ 养成好习惯

🚨 新手必读

以下三个习惯能帮你避免 90% 的问题,请务必养成!

1. 每个项目必须有独立目录

错误做法:在桌面或下载文件夹直接运行 Claude Code 正确做法: bash

# 创建项目专用目录
mkdir ~/projects/my-app
cd ~/projects/my-app
# 然后再启动 Claude Code
claude

为什么重要

  • Claude Code 会修改当前目录的文件
  • 没有独立目录,可能误改其他重要文件
  • 便于后续备份和版本管理

2. 开始前先用 Git 备份

这是最重要的习惯! 有了 Git,你可以随时恢复到之前的状态。 bash

# 进入项目目录后,首先初始化 Git
cd ~/projects/my-app
git init
git add .
git commit -m "初始状态"
# 然后再启动 Claude Code
claude

每次重要修改后: bash

git add .
git commit -m "描述这次修改"

💡 小技巧

让 Claude Code 帮你提交:直接说「请帮我提交代码」

3. 出错后如何恢复

Claude Code 修改出错了?别慌,有多种恢复方法:

方法一:按两次 Esc(最快)

连续按两次 Esc 键,Claude Code 会回退到上一个检查点。

方法二:使用 Git 恢复(推荐)

bash

# 查看修改了哪些文件
git status
# 放弃所有未提交的修改,恢复到上次提交
git checkout .
# 如果已经提交了错误的代码,回退到上一个提交
git reset --hard HEAD~1

方法三:使用 /rewind 命令

bash

# 在 Claude Code 中输入
/rewind

⚠️ 注意

如果没有用 Git 备份,也没有检查点,修改可能无法恢复! 所以一定要养成先备份的习惯。


🚀 开始使用CC

启动 Claude Code

bash

cd 你的项目目录
claude

首次运行会提示登录或配置 API Key。

基本对话

启动后,直接用中文和 Claude 对话:

> 这个项目是做什么的?
> 帮我写一个 hello world 函数
> 帮我提交代码

📝 必会命令

启动命令

命令说明
claude启动新会话
claude -c继续上次对话(最常用!)
claude -r选择历史会话恢复

会话内命令

命令说明
/help查看帮助
/exit退出 Claude Code
/clear清空对话历史
/cost查看费用消耗
/compact压缩对话历史

快捷键

快捷键说明
Ctrl+C中断当前操作
Esc Esc回退到检查点
↑ / ↓浏览历史输入

💡 新手常见问题

Q: 安装失败怎么办?

尝试以管理员身份运行,或使用 --force 参数: bash

npm install -g @anthropic-ai/claude-code --force

Q: 提示权限错误(Windows)?

执行以下命令: powershell

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Q: 如何继续上次的对话?

使用 claude -c 命令。

Q: 如何撤销 Claude 的修改?

按两次 Esc 键,会回退到上一个检查点。

Q: API 连接失败?

  1. 检查 API Key 是否正确配置

📚 初级推荐阅读


🎯 学完初级后

掌握了基本安装和使用后,可以进入 中级教程 学习更多技巧!