听说 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 第一次对话界面

第一次对话界面

第三步:认识基本命令

在 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

![CLAUDE 配置文件](/img/inline/claude-code-beginner-guide-inline-4-claudemd.webp)

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

![项目描述示例](/img/inline/claude-code-beginner-guide-inline-5-project-desc.webp)

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

![代码风格规则](/img/inline/claude-code-beginner-guide-inline-6-code-style.webp)

## 禁止事项
- 不要删除任何现有文件
- 不要执行 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,全部都是在这个基础上延伸出去的。

Claude Code 自动化流程示意

常见问题

对话太长怎么办?

/compact。它会把旧的对话历史压缩,保留重点,释放 context window 的空间。

实用习惯是每工作 15-20 分钟就 compact 一次,避免 context 默默爆掉。

Claude Code 做错事了怎么办?

按 Ctrl+C 中断当前操作。Claude Code 在执行任何有风险的操作(像是写入文件、执行命令)之前,会先跟你确认。看到确认提示时,仔细读一下它要做什么再按 Enter。

如果它已经改坏了文件,用 git checkout -- filenamegit 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