听说 Claude Code 很强,想试试看,但打开 Terminal 就开始紧张。这篇从最基本的步骤带起,30 分钟内完成安装、跑完第一次对话、设好 CLAUDE.md。不需要是工程师,但需要愿意打开 Terminal。
版本提醒一下:Anthropic 在 2026 年 4 月 16 日已经公开介绍 Claude Code 的 Opus 4.7 最佳实践,但实际账号看得到哪些模型,仍以 Claude Code 内建 /model 显示为准。
第一步:安装环境
装 Node.js
Claude Code 需要 Node.js 18 以上。已经有的话跳过这段。
没有的话,最推荐用 nvm(Node Version Manager)来管理:
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# 重新打开 Terminal 后
nvm install 18
nvm use 18
装完跑一下 node -v,看到 v18.x.x 或更高就 OK。
装 Claude Code
npm install -g @anthropic-ai/claude-code
等它跑完,输入 claude --version 确认安装成功。

第二步:第一次对话
在任意文件夹打开 Terminal,输入:
claude
第一次会跳出登入流程,跟着指示完成 Anthropic 账号验证。
登入成功后,会看到一个互动式的对话界面。试着打:
看一下这个文件夹里有什么文件
Claude Code 会用 ls 或类似的命令扫描当前目录,然后告诉结果。
这就是 Claude Code 的基本互动方式。用自然语言说要什么,它选择适合的工具去做。


第三步:认识基本命令
在 Claude Code 的对话里,有一些斜线命令(slash commands)很常用:
| 命令 | 功能 |
|---|---|
/help | 查看所有可用命令 |
/clear | 清除当前对话记录 |
/compact | 压缩对话历史,释放 context |
/cost | 查看目前的 token 用量 |
最常用的是 /compact。对话太长的时候,context window 会爆,跑一下 /compact 把不重要的历史压缩掉,就能继续工作。
也可以直接在 Terminal 里用非互动模式:
claude "把 README.md 里的错字修正"
这样它会做完事情就结束,不会进入互动对话。适合拿来放在 script 里。

第四步:设置 CLAUDE.md
这是让 Claude Code 从「通用 AI」变成「个人化 AI」的关键。
在项目根目录建一个 CLAUDE.md 文件:
touch CLAUDE.md
打开它,写入第一版规则。新手建议先写这三项:
# CLAUDE.md

## 项目描述
这是一个用 Next.js 做的个人博客。

## 代码风格
- 使用 TypeScript
- 偏好 functional component
- 变数命名用 camelCase

## 禁止事项
- 不要删除任何现有文件
- 不要执行 git push
保存后,下次启动 Claude Code 时它会自动读取这个文件。跟它对话的时候,它就会记得这些规则。
CLAUDE.md 从最初的 10 行可以慢慢长成一棵树。但起点就是这么简单。每次发现 Claude Code 做了不想要的事,就去 CLAUDE.md 加一条规则。
进阶:分层设置
CLAUDE.md 可以放在不同层级:
- 项目根目录的 CLAUDE.md:整个项目的规则
~/.claude/底下的设置:所有项目共用的偏好
新手先顾好项目根目录的那个就好,其他的等需要了再加。
第五步:做一个简单的自动化
装好、能对话、设好 CLAUDE.md 之后,来试一个稍微进阶的东西:让 Claude Code 帮忙自动做一件事。
假设每天都要做「打开项目、跑 git pull、看有没有新的 issue」。可以写一个简单的 script:
#!/bin/bash
cd /path/to/your/project
git pull
claude "列出最近 3 个还没解决的 GitHub issue,摘要成一句话"
存成 morning-check.sh,加上执行权限:
chmod +x morning-check.sh
每天早上跑一次 ./morning-check.sh,就是第一个 Claude Code 自动化。
很简单。但这个概念可以往上叠。定时任务、hooks、MCP,全部都是在这个基础上延伸出去的。

常见问题
对话太长怎么办?
跑 /compact。它会把旧的对话历史压缩,保留重点,释放 context window 的空间。
实用习惯是每工作 15-20 分钟就 compact 一次,避免 context 默默爆掉。
Claude Code 做错事了怎么办?
按 Ctrl+C 中断当前操作。Claude Code 在执行任何有风险的操作(像是写入文件、执行命令)之前,会先跟你确认。看到确认提示时,仔细读一下它要做什么再按 Enter。
如果它已经改坏了文件,用 git checkout -- filename 或 git stash 复原。这也是建议在用 Claude Code 之前,先确保项目有 git 版本控制。
怎么让它读特定文件?
直接在对话里跟它说:
读一下 src/config.ts 的内容
它会用内建的文件读取工具打开那个文件。也可以给它相对路径或绝对路径。
命令跑很久没反应?
可能是它在等 API 回应。Claude Code 的速度取决于 API 的回应速度和选的模型。最新的 Opus 通常比较慢,但推理质量最好;Sonnet 仍是大多数日常工作的主力,速度快很多。详细的 Opus / Sonnet 对比见 Claude Opus vs Sonnet 比较。
如果真的卡住了,Ctrl+C 中断后重新输入命令。
下一步
掌握上面 5 步骤之后可以探索:
- hooks:在特定事件触发自订动作
- MCP:连接外部工具和 API
- 定时任务:让 Claude Code 定时做事
这些进阶功能在 Claude Code 完整教程 里有详细说明。
小企鹅的经验
小企鹅的 CLAUDE.md 从最初写的 3 条规则演化到现在的分层多文件架构。重点是「每次踩到坑就加一条」的累积,一开始的版本愈简单愈好。三个月后会发现自己有一份很个人化的 AI 操作手册,这份手册就是 Claude Code 跟其他工具拉开差距的地方。
/compact 是最被低估的命令。Context 默默爆掉是 Claude Code 最常见的卡关点,每工作一段时间就 compact 一次的习惯养成后,session 可以开很久。新手也经常忘记它能直接跑非互动模式(claude "..."),这个用法配 cron 就是最简单的自动化起点。
OpenClaw 多 agent 系统的起点也就是 CLAUDE.md。一条规则一条规则加,慢慢从个人 AI 助手长成多 agent 工作流。新手不用一开始就想得这么远,但可以知道这个工具的天花板很高。
延伸阅读
整理:Penna|小企鹅 Penchan