Claude Code 入门:终端 agent 安装与工作流指南

安装 Claude Code、写好 CLAUDE.md、安全地跑 agent 改代码。价格、模型、权限模式和新手工作流,数据更新到 2026 年 6 月。

一句话总结

Claude Code 是 Anthropic 的命令行编程 agent。它住在你的终端里,能跨整个仓库读文件、改文件、跑命令,是一个任务一个任务地干活,而不是只给你一段代码片段。它只跑 Anthropic 自家模型——Claude Opus 4.7 和 Sonnet 4.6(截至 2026 年 6 月)。要用它得有付费的 Claude 套餐:Pro 每月 20 美元(按年付折合每月 17 美元,现在还附带 Claude Cowork),或 Max 每月 100 美元(5 倍额度)和 200 美元(20 倍)。免费的 Claude.ai 套餐不含 Claude Code。最稳的循环是:用 /init 生成 CLAUDE.md,大改动前用 Shift + Tab 切到规划模式,每轮都审 /diff,提交前先跑测试。

Claude Code 到底是什么

Claude Code 是一个终端 agent。你在项目里跑一条命令 claude,之后 Claude 就能读你的文件、跨多个文件提出并应用改动、运行你的构建和测试命令,然后把结果反馈给你——全程不用离开命令行。

有两个名字经常被搞混,先说清楚:

  • Claude Code:Anthropic 的命令行 AI 编程 agent,能在终端里读、写、运行代码(通过扩展也能在 VS Code 或 JetBrains 里用,背后驱动的是同一个 CLI)。
  • Claude.ai:Anthropic 的网页 / 桌面端对话助手。适合问一次性的问题,但它没法直接动你的仓库。

Claude Code 只跑 Anthropic 模型。截至 2026 年 6 月,阵容是 Claude Opus 4.7(最强,在 SWE-bench Verified 上以 87.6% 排第一)和 Claude Sonnet 4.6(速度更快的主力)。会话中随时用 /model 切换。Pro 套餐默认 Sonnet 4.6,Max 套餐默认 Opus。

这篇适合谁看

熟悉终端的开发者:你能 cd 进目录、看懂 git diff、不用查就会跑 npm test 之类的命令。如果这些还不熟,先补这块——Claude Code 默认你能自己驾驭命令行。

什么时候适合用

多文件改动、需要多步(读、改、跑、修)的 agent 任务,以及探索一个陌生代码库时,优先用 Claude Code。如果只是问一个小问题或写个用完即弃的片段,直接开 Claude.ai 对话更快。

价格与开通(2026 年 6 月)

你需要一个付费的 Claude 订阅。免费的 Claude.ai 不解锁 Claude Code。

套餐价格(美元 / 月)额度(相对 Pro)能拿到什么
Pro20(按年折合 17)基准Claude Code + Claude Cowork;默认 Sonnet 4.6
Max 5x1005 倍更高额度,默认 Opus,优先体验新功能
Max 20x20020 倍重度日常 agent 工作的最高额度

有两点容易踩坑。第一,Claude Code 和 Claude.ai 对话共用同一份额度——在网页里聊得多,就会吃掉终端 agent 能用的那一份。第二,Team Standard(每席 20 美元)不含 Claude Code;含它的最低档是 Team Premium(每席 100 美元,最少 5 席)、Enterprise,或者任意个人 Pro / Max 套餐。你也可以不订阅,改用 Anthropic API key(Console 账号)按量付费。最新数字请看 Claude 价格页

安装

Anthropic 推荐的方式是原生安装脚本(后台自动更新)。系统要求:macOS 13+、Windows 10 1809+,或 Ubuntu 20.04+ / Debian 10+,内存 4 GB。

# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

更喜欢用包管理器?macOS 上 brew install --cask claude-code,Windows 上 winget install Anthropic.ClaudeCode,或者用 npm 全局包(需要 Node.js 18+):

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

npm 安装千万别加 sudo——会引发权限问题。如果遇到 EACCES 报错,用 nvm 这类 Node 版本管理器,或把 npm 的全局目录指到你自己拥有的目录。装好后确认版本,再跑一次健康检查:

claude --version
claude doctor

第一次跑 claude 会弹出浏览器让你登录。完整选项见官方安装文档

60 秒跑通第一个任务

  1. cd 进项目根目录(有 package.jsonpyproject.tomlCargo.toml.git 的那一层)。
  2. claude,在浏览器里完成登录。
  3. 输入 /init 生成 CLAUDE.md
  4. 给它一个小而具体的任务:给 src/server.ts 加一个 /health 端点,返回 200 和构建 SHA。先给我计划,别急着改代码。

快捷键指南

Claude Code 的快捷键会受终端、IDE、系统和版本影响。最稳的做法是:在会话里按 ? 看当前环境可用快捷键;如果 Shift + Enter 不能换行,先跑 /terminal-setup

快捷键 / 输入作用什么时候用
?显示当前环境快捷键帮助忘了按键、换了终端、刚装好时先看
Ctrl + C取消当前输入或中断生成Claude 跑偏、命令执行太久、想重新提问
Esc中断 Claude 当前回复或工具调用想保留已完成部分,但马上改方向
Esc 然后再按 Esc打开 rewind / checkpoint 菜单需要回到前面某一步,或撤回一段会话/代码状态
Shift + Tab切换权限模式:默认、自动接受编辑、Plan 等从”先规划”切到”允许改文件”,或反过来收紧权限
Ctrl + R搜索历史输入找回之前写过的长 prompt 或命令
/ 浏览历史输入;多行输入时也会移动光标快速复用上一条任务描述
Ctrl + O打开详细 transcript 视图想看 Claude 读了哪些文件、跑了哪些工具
Ctrl + L重绘终端屏幕终端显示乱了、输出残影时刷新
Ctrl + B把正在跑的任务放到后台长命令或长任务不想占住当前界面
Ctrl + T显示 / 隐藏任务列表同时有后台任务、subagent 或长命令时查看进度
Ctrl + A / Ctrl + E跳到当前行开头 / 结尾编辑长 prompt
Ctrl + K / Ctrl + U / Ctrl + W删除到行尾 / 删除到行首 / 删除前一个词快速改写输入,不用狂按退格
Ctrl + Y粘回刚才删除的文本误删 prompt 片段时恢复
Shift + Enter换行输入写多段需求、贴日志、列 checklist
Ctrl + J通用换行输入某些终端不支持 Shift + Enter 时备用
\ 然后 Enter通用换行输入任何终端都能用的换行方式
/ 放在开头打开命令 / skill 菜单/plan/diff/skills、自定义 skill
@ + 路径引用文件或目录明确让 Claude 读取某个文件、组件、配置目录
! 放在开头进入 shell mode,把命令输出带回上下文让 Claude 看到 npm testgit status、日志输出

macOS 用户如果想用 Option + P 切模型、Option + T 切 thinking、Option + O 切 fast mode,可能需要在终端里把 Option 配成 Meta。iTerm2、Apple Terminal、VS Code 的设置位置不一样;如果按键没反应,优先检查终端设置。

工作循环,一步一步来

1. 从正确目录启动

先进入项目根目录,再运行:

claude

根目录通常是有 package.jsonpyproject.tomlCargo.toml.git 的那层。不要从 src/app/components/ 这种子目录启动,否则 Claude 容易只看到局部结构。

2. 先初始化项目记忆

第一次进仓库先跑:

/init

它会生成或更新 CLAUDE.md。这份文件建议写:

  • 项目是什么、主要技术栈是什么。
  • 常用命令:安装、开发、测试、构建、格式化。
  • 目录结构:页面、组件、API、脚本、测试分别在哪里。
  • 不能碰的文件:生产配置、迁移文件、大型生成产物、密钥相关文件。
  • 代码风格:命名、组件组织、错误处理、测试习惯。

之后可以用 /memory 查看或编辑当前生效的 CLAUDE.md

3. 大改动前先规划,并搞清楚权限模式

大改动不要一上来就让它写代码。按 Shift + Tab 可以循环切换本次会话的权限模式,状态栏会显示当前在哪一档:

  • default(默认)——每次改文件、每条命令前都问你。
  • acceptEdits(自动接受编辑)——改文件和基础文件系统命令不再询问,但其他 Bash 命令仍会提示。适合”改完就看 git diff”的快循环。
  • plan(规划)——Claude 只研究并提出方案,不动任何东西。批准计划后退出规划模式,开始改代码。

还有一个 auto 模式(需要 Claude Code v2.1.83+):由一个独立的分类器模型在每个动作执行前先审一遍,挡掉任何超出你要求、想擅自升级的操作——比 bypassPermissions 安全得多。bypassPermissions 会完全关掉检查,只应该在用完即弃的容器或 worktree 里跑。

切到规划模式,给它一个限定范围的任务:

给登录页加忘记密码流程,先读相关文件并提出实现计划,不要改代码。

你要检查三件事:

  • 它读的文件对不对。
  • 它的计划有没有越界,比如顺手重构无关模块。
  • 它是否列出了验证方式,比如单测、构建、手动检查路径。

如果计划太大,直接让它拆小:“只做 UI,不接 API”、“只改这 2 个文件”、“先写测试,不实现”。

4. 用 /skills 和具体 /skill-name

很多人会说”用 /skill”,但当前更稳的理解是:

  • 输入 / 可以打开所有可用命令、内置 workflow、插件命令和 skill。
  • 输入 /skills 可以查看当前会话可用的 skills。
  • 具体执行某个 skill 时,通常输入它自己的斜杠名字,比如 /security-review/simplify/claude-api,具体以你的 / 菜单显示为准。
  • 自定义 skill 一般放在 .claude/skills/<name>/SKILL.md,调用名通常就是 /<name>

什么时候用 skill:

  • 任务有固定流程,比如安全审计、发布检查、API 迁移、文档生成。
  • 需要附带参考文档、脚本、模板,而不是一段简单 prompt。
  • 团队希望所有人按同一套检查清单执行。

什么时候不用 skill:

  • 只是一次性小问题,直接 prompt 更快。
  • 只想复用一句短指令,用自定义 slash command 或 prompt 模板就够。

5. 执行时给边界

批准计划后,给 Claude 一个窄任务:

按刚才计划执行第 1 步。只修改 src/routes/auth 和 src/components/auth 里的文件。不要提交。完成后列出改动文件和验证命令。

好边界通常包含:

  • 允许改哪些目录或文件。
  • 禁止改哪些目录或文件。
  • 本轮只做哪一步。
  • 完成后要跑什么验证。
  • 不要自动 commit,除非你明确要求。

6. 审 diff,再继续

每完成一轮,先看:

/diff

重点看三类问题:

  • 是否改了不相关文件。
  • 是否引入了新的依赖、配置或环境变量。
  • 是否只是让代码”看起来更完整”,但没有覆盖真实路径。

如果 diff 不对,可以用 Esc 中断,或 Esc + Esc 打开 rewind。轻微问题可以直接说:“保留 A,撤回 B,只修 C”。

7. 用测试和构建收尾

让 Claude 跑验证前,先明确命令:

运行 npm test 和 npm run build。如果失败,先解释失败原因,不要直接大改。

如果项目没有测试,至少让它做:

  • git diff --check 检查空白错误。
  • 类型检查或构建。
  • 关键页面 / API 的手动检查清单。
  • 列出无法验证的部分,让你人工确认。

8. 长任务要会清上下文

上下文变长后,优先用:

  • /context 看上下文被什么占住。
  • /compact 压缩当前会话,并加一句重点:“保留已改文件、待办、验证结果、不要保留闲聊。”
  • /clear 开新任务,保留 CLAUDE.md 项目记忆。
  • /resume 回到之前会话。

一个实用习惯:每完成一个阶段,让 Claude 写一段状态:

请总结当前状态:已改文件、关键决策、测试结果、剩余待办、下一步建议。控制在 20 行内。

9. 推荐的新手顺序

  1. claude 进入项目。
  2. /init 生成 CLAUDE.md
  3. Shift + Tab 切到规划模式再动手。
  4. 批准一个小步骤。
  5. /diff 审改动。
  6. 跑测试 / build。
  7. 手动 commit。
  8. 再进入下一步。

最费时间的三个错误

  • 从子目录启动。 在仓库根目录跑 claude,别在 src/ 里跑——否则 agent 只看到局部结构,会改错文件。
  • 不写 CLAUDE.md 没有它,每次会话都要重新猜你的技术栈和约定,而且经常猜错。
  • 不审就让它提交。 每一轮都先看 /diff。不审就提交是回归 bug 的头号来源。

FAQ

Q:Claude Code 多少钱? A:它包含在付费 Claude 套餐里:Pro 每月 20 美元(按年付折合每月 17 美元),或 Max 每月 100 美元(5 倍额度)和 200 美元(20 倍),数据截至 2026 年 6 月。免费的 Claude.ai 套餐不含它。你也可以用 Anthropic API key 按量付费。注意 Claude Code 和 Claude.ai 对话共用一份额度,网页里聊得多会减少终端 agent 能用的部分。

Q:Claude Code 用哪个模型,能换吗? A:只跑 Anthropic 模型——Claude Opus 4.7(最强)和 Sonnet 4.6(更快)。Pro 默认 Sonnet 4.6,Max 默认 Opus。随时用 /model 切换。它跑不了 GPT-5.5 或 Gemini;想用那些就改用 Cursor 这种支持多模型的 IDE。

Q:一定要会命令行吗? A:基本的终端操作是必须的。你要在项目根目录跑 claude、切换目录、看懂 diff 输出。如果 cdgit statusls 还不熟,先补这块。

Q:CLAUDE.md 是干什么的? A:它是 Claude Code 每次运行都会读的项目说明书——代码约定、构建和测试命令、目录结构、以及哪些文件别碰。用 /init 生成,用 /memory 编辑。

Q:Claude Code 会自动帮我提交吗? A:只有你明确要求时才会。默认它只改文件、不提交。保持这个习惯,先审 /diff,把它的产出当成新人提的 PR 来看。

Q:这和直接在 Claude.ai 聊有什么区别? A:Claude.ai 是网页对话,碰不到你的仓库。Claude Code 是住在终端里的 agent,能读写文件、跑命令。一次性问题用 Claude.ai,真实代码库里的多文件改动用 Claude Code。

相关阅读

标签: #Claude #教程 #Claude Code