Claude Code Manual
第一次使用
第一次使用，从一个只读问题开始：观察它怎样读文件、怎样回答；再让它做一个小修改，体验审批和验收。
准备一个练习文件夹
不要一上来就在重要项目里试。可以用 小白学AI 练习包，或者复制一个不要紧的文件夹。
先进入练习文件夹（把路径换成你自己的）：
cd ~/ai-course/practice-claude确认提示符显示的是这个文件夹以后，再用 Git 存档：
git init
git add .
git commit -m "开始之前"启动
claude第一次启动时：
- 选择界面配色。
- 如果还没配置凭证，会要求登录；接入 XAI Router 的方法见凭证与接入 XAI Router。
- 询问是否信任这个文件夹。确认是你自己的文件夹后再选择信任。
进入后，底部是输入框，状态栏显示当前的权限模式。
第一个问题：只读
按 Shift + Tab 切换到 plan mode on，然后输入：
请先不要修改任何文件。告诉我这个文件夹里有哪些文件、各自是什么内容，有没有看起来重复的文件。Claude Code 会运行一些读取命令，然后给出报告。核对一下它说的对不对，这是使用 AI 的基本功。
第二个任务：小修改
切换回 manual mode on，让它做一件小事，并要求先说方案：
请新建一个 summary.md，汇总所有会议纪要里的待办事项（负责人、事项、截止日期）。先告诉我你打算怎么做，等我确认后再动手。确认方案后回复“可以”。它要创建文件时会弹出审批提示，看清楚内容再允许。
完成后，在终端里运行 git status，summary.md 会出现在 Untracked files（新文件）里。新文件不会出现在 git diff 中，直接打开 summary.md 检查内容即可。
满意就提交存档；不满意，可以让它修改，或者连按两次 Esc 回退。
输入框里的小技巧
| 操作 | 作用 |
|---|---|
@文件名 | 指定要它看的文件，例如 @expenses-2026-09.csv 帮我算总额 |
!命令 | 直接在终端里运行一条命令，例如 !git status，结果会进入对话 |
Esc | 打断它正在做的事 |
Esc Esc | 输入框为空时连按两次，打开回退菜单 |
↑ | 调出之前输入过的内容 |
Shift + Tab | 切换权限模式 |
/help | 查看所有命令 |
退出
输入 /exit，或者连按两次 Ctrl + D。下次在同一个文件夹里运行 claude -c，可以接着上次的对话继续。
好任务的写法
一个清晰的任务包含：
- 目标：要完成什么。
- 范围：只动哪些文件。
- 限制：什么不能做，例如“不要删除文件”。
- 验收：怎样算完成，例如“做完列出改了哪些文件”。
把大任务拆成小任务，做完一个、检查一个、存档一个，结果会稳定得多。