Claude Code 使用指南：安装、CLAUDE.md 配置与 Skills 实战

交互模式#

在项目根目录运行 claude，进入持续对话的交互模式：

1
cd your-project
2
claude
3
# 进入交互模式，Claude 自动读取目录结构

Claude Code 启动时会扫描当前目录的文件结构，不需要手动描述项目布局。

单次命令模式#

直接在命令后跟问题，执行后退出：

1
claude "review the changes I just made"
2
claude "the test in auth.test.ts is failing, fix it"
3
claude "找出所有没有处理错误的 async 函数"

常用交互指令#

在交互模式下可以用斜杠命令：

推荐写法#

1
# 项目说明
2

3
这是一个 Fastify + Prisma 的 REST API 项目，TypeScript 编写。
4

5
## 技术栈
6
- Node.js 22，TypeScript strict 模式
7
- 测试框架：Vitest（不用 Jest）
8
- ORM：Prisma，不写原生 SQL
9

10
## 代码约定
11
- 函数式优先，避免 class
12
- 变量命名用 camelCase
13
- 提交信息格式：`type(scope): message`，描述用中文
14

15
## 常用命令
16
- `npm run dev` 启动开发服务器
17
- `npm test` 运行测试
18
- `npx prisma studio` 打开数据库 GUI

多级 CLAUDE.md#

Claude Code 会读取以下位置的 CLAUDE.md，全部叠加生效：

1
~/.claude/CLAUDE.md          # 全局指令，所有项目共用
2
project/CLAUDE.md            # 项目根目录
3
project/src/CLAUDE.md        # 子目录，只在该目录内的操作时生效

全局 CLAUDE.md 适合放个人习惯（如偏好的代码风格、语言偏好），项目级放项目约束。

权限模式#

启动时可以指定权限级别：

1
# 默认模式：每次敏感操作都请求确认
2
claude
3

4
# 自动批准所有操作（适合脚本化场景，谨慎使用）
5
claude --dangerously-skip-permissions

哪些操作会请求确认#

• 写入或删除文件
• 执行 shell 命令
• git 操作（commit、push 等）
• 网络请求

只读操作（读文件、搜索代码、运行测试）不需要额外确认。

修复测试#

1
claude "auth.test.ts 里的第 3 个测试在报 TypeError，帮我修复"
2
# Claude 读取测试文件和被测文件，定位问题，直接修改代码

代码审查#

1
claude "review the changes I just made, focus on security issues"
2
# Claude 读取 git diff，输出审查意见

跨文件重构#

1
claude "把项目里所有用 callbacks 写的异步函数改成 async/await，保持逻辑不变"
2
# Claude 搜索整个项目，批量修改，修改前显示计划

理解陌生代码库#

1
claude "解释一下 src/auth 目录的整体结构，以及各文件之间的调用关系"
2
# Claude 遍历目录，输出结构说明

搭配 MCP 使用#

Claude Code 本身不直接使用 MCP，但可以和配置了 MCP 的 Claude Desktop 互补：Claude Code 负责文件操作和 git，Claude Desktop 负责需要外部工具（数据库查询、GitHub API 等）的任务。MCP 配置方式参考 MCP 系列。

claude 命令找不到，提示 command not found#

npm 全局安装后，claude 命令需要在 PATH 里。检查：

1
```bash
2
# 查看 npm 全局安装目录
3
npm root -g
4

5
# 查看全局 bin 目录
6
npm bin -g
7
# 输出如 /usr/local/bin，确认这个路径在你的 PATH 里
8
```
9

10
如果不在 PATH 里，在 `~/.zshrc` 或 `~/.bashrc` 里追加：
11

12
```bash
13
export PATH="$(npm bin -g):$PATH"
14
```
15

16
然后 `source ~/.zshrc` 使配置生效。

授权完成后还是提示未登录#

删除本地凭证文件，重新走一遍授权：

1
```bash
2
rm -rf ~/.claude/credentials.json
3
claude
4
# 重新走授权流程
5
```

Claude Code 会读取哪些文件？#

Claude Code 读取你主动提及的文件、当前目录的结构（文件名和路径），以及执行任务时它认为相关的文件（会先告知再读取）。不会主动读取 .gitignore 里排除的文件或目录外的文件。敏感信息建议放在 .env 并加入 .gitignore。

如何控制 Claude Code 不修改某些文件？#

在 CLAUDE.md 里明确说明：

1
```markdown
2
## 禁止修改的文件
3
- `src/config/production.ts`：生产配置，不要直接修改
4
- `*.lock` 文件：不要手动编辑依赖锁定文件
5
```
6

7
也可以在对话里直接说"不要修改 X 文件"，Claude Code 会遵守。

token 消耗太快怎么控制？#

几个降低 token 消耗的方法：① 用 /compact 压缩上下文；② 任务完成后用 /clear 开新对话，不要把多个不相关任务堆在一个会话里；③ 用单次命令模式（claude "..." 而不是交互模式）处理独立任务，避免上下文积累。