Claude Code 是 Anthropic 在 2025 年推出的 CLI 工具,到 2026 年已经是不少 Terminal 重度用户的日常主力。它能直接读写文件、跑命令、操作 git、接 MCP 外部工具,跟 Claude/ChatGPT 网页版那种「贴代码、得回复、自己改」的工作流完全不同。这篇从安装到 hooks / MCP / 调度一次整理。

零基础先不要被 Terminal 吓到。真正的入门顺序很短:装 Node.js、装 Claude Code、登录、在一个安全文件夹跑第一次对话、建立 CLAUDE.md。等它能稳定读文件、改小段文字、让你看得懂 diff 之后,再往 hooks、MCP、定时任务推进。完整逐步版放在 Claude Code 新手入门

Claude Code 是什么

Claude Code 是 Anthropic 官方推出的 agentic 开发工具,有 CLI、Desktop 和 Cloud 三种形式。在 Terminal 里输入 claude,就能跟 Claude 对话,它会直接操作文件系统。

跟 Claude/ChatGPT 网页版的差别在这里:Claude/ChatGPT 活在浏览器里,贴代码给它看,它回修改建议,再手动复制贴上。Claude Code 直接读项目文件夹,改完自己保存。

实际使用感:输入「把这个函数的错误处理补上」,它真的打开文件、找到那个函数、加上 try-catch、存档。只需要看 diff 确认没问题就好。

Claude Code Terminal 界面示意

跟其他 AI coding 工具最大的差异:Claude Code 没有图形界面。没有侧边栏、没有漂亮的按钮,就是一个 Terminal。对习惯 CLI 的人是优点,对不习惯的人是门槛。完整的对比见 Claude Code vs Cursor

安装步骤

前置需求

  • Node.js 18 以上(建议用 nvm 管理版本)
  • macOS 或 Linux(Windows 用 WSL2)
  • Anthropic 账号

安装流程

npm install -g @anthropic-ai/claude-code

装完之后在 Terminal 输入:

claude

第一次启动会要登入 Anthropic 账号,跟着指示走就好。登入成功后就可以开始对话。

装完先跑一个简单的测试确认环境没问题:

claude "列出目前文件夹里的所有 .md 文件"

它应该会用 lsglob 帮你找出来。能正确回应代表安装成功。

常见安装问题

Node.js 版本太旧:用 node -v 检查,低于 18 就升级。nvm 的话 nvm install 18 && nvm use 18

权限问题:macOS 上如果遇到权限错误,不要用 sudo npm install -g,改用 nvm 管理 Node.js 就不会有这个问题。

新手入门的完整步骤在 Claude Code 新手入门

核心功能

Claude Code 是一款 Terminal AI,它在你的文件夹里工作

Claude Code 最基本的能力就是在 Terminal 里当 AI 助手。它能做的事:

  • 读写文件:直接看代码、修改、建立新文件
  • 执行命令:跑 git、npm、任何 CLI 工具
  • 搜索代码:用 grep/glob 在整个项目里找东西
  • 理解上下文:它会读 CLAUDE.md 和相关文件,知道项目在做什么

实用场景:代码审计。丢一句「检查最近的 commit 有没有安全问题」,它会跑 git diff、逐个文件看、回报潜在风险。原本 review 要花 30 分钟的东西,3 分钟看完它的报告就好。

Hooks:自动化触发

Hooks 让你在特定事件发生时自动执行动作。比方说:

  • 每次 Claude Code 要执行 bash 命令前,先检查有没有危险操作
  • 对话结束时,自动更新工作记忆
  • 文件修改后,自动跑 linter

设置在 settings.json 里。一个常见的 hook 设置:在 Claude Code 要跑任何 git push --force 之前先挡下来,避免手残推坏 production。

Hooks 是 Claude Code 跟纯聊天工具最大的差别之一。它让 AI 的行为可以被约束、被自动化。

MCP:无限扩充能力

MCP(Model Context Protocol)是 Claude Code 的插件系统。通过 MCP,可以让 Claude Code 连接各种外部工具。

常见的 MCP server:浏览器操作、数据库查询、外部 API。设置好之后,可以直接在 Terminal 里跟 Claude 说「查一下这个 API 的返回格式」,它就会通过 MCP 去调用。

MCP 的配置文件放在 .claude/ 文件夹底下,JSON 格式,定义每个 server 的连接方式和可用工具。

Scheduled Tasks:定时任务

Claude Code 支持 /loop 命令设置重复任务,可以每日或每周执行。桌面版最长跑 3 天,Anthropic 云端版则可以无限期运行。

常见的定时任务:

  • 每天早上跑内容调度,把写好的草稿发到 Buffer
  • 定时做代码健检
  • 每周整理工作记忆,把过期的信息清掉

定时任务搭配 hooks 使用特别强。任务跑完自动触发通知、自动更新状态文件,整个流程不用人介入。

Claude Code 定时任务流程

CLAUDE.md:让 AI 记住你的规则

Claude Code 设计最聪明的地方就是 CLAUDE.md,它能记住所有你需要它记得的事情(在设计好的前提下)。

在项目根目录放一个 CLAUDE.md,Claude Code 每次启动时自动读取。可以在里面写:

  • 项目的代码规范
  • 禁止做的事(比如不准 git push --force
  • 偏好的工具和流程
  • 文件结构说明

合理的演化:从 10 行开始,每次踩到坑就加一条规则。三个月后会有一份非常个人化的 AI 操作手册。

这跟 Cursor.cursorrules 类似,但 Claude Code 的生态系让 CLAUDE.md 可以做更多事,像是跨文件的规则引用、分层加载。

跟 Cursor 的差异

两个都用过,结论是:定位完全不同。

比较项目Claude CodeCursor
界面Terminal(CLI)IDE(图形界面)
上手难度中高,要熟 Terminal低,装了就能用
弹性极高,能跑任何命令中等,受 IDE 框架限制
自动化hooks + 调度 + MCP有限
适合谁CLI 爱好者、DevOps、重度自动化前端、一般开发者、想快速上手

选 Claude Code 的常见理由是工作流本来就在 Terminal 里。git、npm、docker,全部在 Terminal 操作。多一个 AI 助手在同一个环境里,比切到另一个 IDE 自然得多。

完整的 Cursor 对比看 Claude Code vs Cursor 比较

Claude Code / Cursor / Copilot 怎么选

使用情境建议工具理由
熟 Terminal、要 repo-wide 任务、调度、自动化Claude CodeCLI 原生,能读写文件、跑命令、接 hooks / MCP
写前端、需要实时预览、想在 IDE 里看 diffCursor图形界面、inline diff、多文件 Composer 更顺
团队已经活在 GitHub PR / issue 流程GitHub CopilotPR review、issue → PR、组织治理整合最深
自建 OpenAI-family coding pipelineCodexAPI / token billing 入口,适合客制化整合

这张表来自 Claude Code vs Cursor 的核心判断:Claude Code 和 Cursor 不是谁取代谁,而是入口不同。Claude Code 是 Terminal agent,Cursor 是 AI IDE,Copilot 是 GitHub 工作流插件。

进阶使用场景

多 Agent 管理

OpenClaw 是一个用 Claude Code 搭起来的多 agent 系统。四个 agent 各自负责不同的事:Opus 做策略、Sonnet 跑机械任务、Codex 写程序、Gemini 给意见。

Claude Code 是这整个系统的操作界面。在 Terminal 里切换 agent、分派任务、检查各个 agent 的输出。

内容产制

长文初稿可以在 Claude Code 里产出。给它大纲和风格指南,它生成草稿,再修改润饰。整个过程不用离开 Terminal。

代码审计

每次有新的 commit,可以让 Claude Code 做一轮安全检查。它会看 diff、找潜在的注入风险、检查有没有机密信息不小心被 commit 进去。

踩坑记录

Context window 爆掉:Claude Code 的对话有 token 上限。一开始把所有记忆文件都塞进 CLAUDE.md,800 多行,每次对话光加载就吃掉一大堆 context。后来拆成分层架构,只在需要时才读特定文件,context 用量砍了一半。

Hook 写坏导致无穷循环:把 hook 设置成「每次文件变更就跑 lint」,但 lint 会自动修正文件,触发下一次 hook。连锁反应跑了几十次才被 Ctrl+C 停掉。教训:hook 的触发条件要设防护,避免自己触发自己。

定时任务时区问题:设置调度时用了 UTC,但服务器在台湾时区。结果早上 8 点的任务在凌晨 0 点就跑了。检查调度的时候务必确认 wall clock 跟设置的时区一致。

新手从这里开始

第一次接触 Claude Code 的建议路线:

  1. 先装好环境,跑几个简单的对话,感受一下
  2. 在项目里建一个 CLAUDE.md,写三条最在意的规则(或直接请 Claude 帮你写)
  3. 试着让它帮忙做一件每天都在做的事
  4. 踩到坑就更新 CLAUDE.md,慢慢累积

更详细的新手指南可以看 Claude Code 新手入门

小企鹅的经验

小企鹅主力是 Claude Code,每天 Terminal 第一件事就是启动它。写文章、写程序、管理调度、管多 agent 系统,全部在里面完成。CLAUDE.md 已经演化成一整套规则系统,从最初 10 行长到现在分层的多文件架构,这套规则设计是 Claude Code 跟其他 AI coding 工具差别最大的地方。

OpenClaw 多 agent 系统就是基于 Claude Code 搭起来的:Opus 做策略 / Sonnet 跑机械任务 / Codex 写程序 / Gemini 第三方意见。一般用户用不到这个复杂度,但想试试多 agent 工作流的话,Claude Code 是目前唯一支持得起来的工具。

Cursor 没进日常工作流,因为工作流本来就在 Terminal 里。试 Cursor 那种 IDE 路线是通过 Antigravity,能直接看着项目、写 code 时 AI 主动跳出提示对习惯 IDE 的人很顺手。但小企鹅的工作偏「设置好让它自己跑」的自动化路线,hooks + 调度 + MCP 目前是其他工具追不上的。

延伸阅读

常见问题

Q: Claude Code 是什么?

Claude Code 是 Anthropic 推出的 CLI 工具,直接在 Terminal 里跟 Claude 互动。它能读写文件、执行命令、搜索代码,适合开发者在自己熟悉的终端环境里用 AI 辅助开发。

Q: Claude Code 需要付费吗?

Claude Code 需要 Pro($20/月)以上的 Anthropic 订阅方案,或用 API 计费。重度用户可以考虑 Max 5x($100/月)或 Max 20x($200/月),用量分别是 Pro 的 5 倍和 20 倍。

Q: Claude Code 跟 Cursor 差在哪?

Claude Code 跑在 Terminal,适合习惯 CLI 的开发者,弹性高但门槛也高。Cursor 是 IDE,有图形界面和实时预览,适合想在编辑器里直接用 AI 的人。两者定位不同,不是替代关系。

Q: CLAUDE.md 是什么?有什么用?

CLAUDE.md 是放在项目根目录的配置文件,Claude Code 每次启动会自动读取。可以在里面写项目规则、代码风格、注意事项,让 AI 每次都记得你的偏好,不用重复交代。

Q: Claude Code 可以自动执行定时任务吗?

可以。Claude Code 支持 scheduled tasks,可以设置定时执行的任务,像是每天自动跑代码审计、发布内容、更新数据。

Q: Claude Code 支持哪些操作系统?

Claude Code 支持 macOS 和 Linux。Windows 用户可以通过 WSL2 来使用。安装需要 Node.js 18 以上的环境。

Q: Claude Code 的 MCP 是什么?

MCP(Model Context Protocol)让 Claude Code 可以连接外部工具和数据来源,像是数据库、API、浏览器等。通过 MCP,Claude Code 的能力可以无限扩充。


整理:Penna|小企鹅 Penchan