🌱 初级教程 - 入门篇
适合:完全没有使用过 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 --forceQ: 提示权限错误(Windows)?
执行以下命令: powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedQ: 如何继续上次的对话?
使用 claude -c 命令。
Q: 如何撤销 Claude 的修改?
按两次 Esc 键,会回退到上一个检查点。
Q: API 连接失败?
- 检查 API Key 是否正确配置
📚 初级推荐阅读
🎯 学完初级后
掌握了基本安装和使用后,可以进入 中级教程 学习更多技巧!