Claude Code CLI 新手教程

第 4 章:第一次会话

cd 进项目、运行 claude、提问「这个项目做什么?」、用 /init 生成 CLAUDE.md,并了解 Auto / Manual 权限模式。

/init Auto 模式 Shift+Tab

1进入项目并启动

打开终端,进入你要工作的项目目录,启动 Claude Code:

cd /path/to/your/project
claude

将 /path/to/your/project 替换为实际路径。终端会显示版本、当前模型与工作目录,等待你输入。

2第一个问题:了解项目

用自然语言提问,Claude 会自动读取相关文件并回答。试试这些:

what does this project do?
what technologies does this project use?
where is the main entry point?
explain the folder structure

也可以问 Claude Code 自身的能力:

what can Claude Code do?
无需手动添加文件上下文——Claude 会按需读取项目文件。

3用 /init 创建 CLAUDE.md

CLAUDE.md 是项目根目录的 Markdown 文件,Claude 每次会话开始时都会读取,用于记录编码规范、架构决策、常用命令等「项目记忆」。

在会话中运行:

/init

Claude 会分析你的代码库并生成一份初始 CLAUDE.md,之后你可以手动编辑完善。详见第 7 章扩展能力。

4第一次改代码

尝试一个简单的编码任务:

add a hello world function to the main file

Claude 会定位合适文件并展示变更。若弹出确认提示,选择 Yes 批准修改。

5权限模式:Auto vs Manual

Claude Code 有两种主要权限模式,决定编辑文件和运行命令时是否需要你确认:

Auto 模式
  • Pro、Max、Team 计划交互会话的默认起始模式
  • 分类器审查操作,多数编辑与命令无需逐项确认
  • 适合快速迭代、信任项目环境的场景
Manual 模式
  • 其他计划的默认起始模式
  • 每次文件编辑、命令执行前需你批准
  • 适合敏感项目或需要严格控制的场景

随时按 Shift+Tab 在当前会话中切换权限模式:

Shift+Tab  →  循环切换 Auto / Manual 等模式
组织或个人设置可能覆盖默认起始模式。安装后首次会话的默认模式以你的计划与配置为准。

6新手小技巧

  • 描述要具体:「修复登录页输错密码后白屏的 bug」比「修 bug」更有效
  • 复杂任务分步:先建表,再写 API,最后做前端页面
  • 改代码前先让 Claude 分析:analyze the database schema
  • 输入 / 查看可用命令与 Skills 菜单
Claude Code CLI 新手教程 · 第 4 章