Claude Code 入门：安装、登录与第一次高效会话
Posted on Fri 25 September 2026 in AI 编程 • Sucre Liu
先纠正一个预期
很多人第一次打开 Claude Code，输入"帮我写一个博客系统"，然后失望地关掉——因为它没有一口气吐出整个项目。
问题不在工具，而在预期。Claude Code 不是"更快的代码补全"，它是一个能在你的终端里连续行动的代理：读文件、跑命令、改代码、看结果、再决定下一步。你给的是一个目标，它自己规划路径。理解这一点，后面的所有用法才顺。
本文是系列第一篇，目标只有一个：让你从"会打开"到"会用它干一件真事"。本文基于 Claude Code 2.1.281。
agentic loop：它到底在循环什么
Claude Code 的核心是一个三步循环：
- 收集上下文——搜索文件、读代码、看 git 状态；
- 采取行动——改文件、跑命令、装依赖；
- 验证结果——跑测试、看报错、再修正。
一个"修 bug"的任务，会在这个循环里转很多圈。你问一个代码问题，可能只停在第一步。这个循环由两样东西驱动：会推理的模型，和会动手的工具。
内置工具大致分五类，决定了它能做什么：
| 类别 | 能干什么 |
|---|---|
| 文件操作 | 读、改、新建、重命名 |
| 搜索 | 按模式找文件、正则搜内容 |
| 执行 | 跑 shell、起服务、跑测试、用 git |
| 网络 | 搜网、抓文档、查报错 |
| 代码智能 | 改完看类型错误、跳转定义/引用（需装语言插件） |
关键区别在这里：它看到的是整个项目，而不是你当前打开的那个文件。所以它能跨文件协调修改，也能自己去找那个你没告诉它在哪的 bug。
安装与登录
npm install -g @anthropic-ai/claude-code
claude --version
在项目根目录直接运行 claude 就进入交互式会话。首次使用需要登录，按提示完成即可。装完先跑一次自检：
/doctor
它会检查安装与配置，能修的直接给出修复动作。这一步比出问题后再排查省事得多。
第一次会话：别拿它练手，拿它办正事
我的建议是：第一次就用一个你这周真的要做的小任务，而不是"写个 demo"。真实任务的上下文、约束、验收标准，才是它的用武之地。
一个可复制的开场方式：
支付流程对过期卡的判断有问题，相关代码大概在 src/payments/。
先别改，帮我定位是哪一段逻辑，并说明你判断的依据。
注意最后那句"先别改"。这不是客套，它把会话压到了"只读探索"阶段，能让你在动手前核对它的理解是否正确。这和按 Shift+Tab 切到 plan 模式是一个道理。
它给出的定位你不满意，也不需要重开：
不太对，问题出在 session 处理，不是卡号校验。
它会在这个基础上调整，而不是从零重来。对话式迭代，是这个工具的基本节奏。
几个必须记住的控制键
这几个操作能显著改变你的体验：
Esc：立刻打断。正在跑的工具体调用会被取消，它停下来等你下一句。EscEsc：回退。改文件之前它会给文件做快照，连按两次可以退回到之前的状态。这是它独立于 git 的一层安全网。Shift+Tab：循环切换权限模式（下面详说）。- 直接输入+回车：任务还在跑时，你的消息会进入队列，它会在这轮工具调用结束后读到并调整。
其中 Esc Esc 值得多用。很多人被"AI 乱改文件"吓到，其实它每次编辑前都留了检查点，退回去的成本很低。
权限模式：别默认全放开
这是最容易出事、也最容易被忽视的一块。模式决定"哪些动作不用问你"：
| 模式 | 不问就执行 | 适合 |
|---|---|---|
Manual（配置值 default） |
只读 | 敏感代码、不熟悉的项目 |
| Accept edits | 读 + 改文件 + 常见文件系统命令 | 你打算稍后用 git diff 复查 |
| Plan | 只读 + 探索 | 动手前先看方案 |
| Auto | 几乎所有动作，后台有分类器拦截 | 长任务、减少打断 |
| Bypass permissions | 全部 | 仅限容器/虚拟机 |
有两条经验：
- 新项目、生产仓库，从 Manual 或 Plan 起步。 不要为了少点几下就上
bypassPermissions。 - 规则问题用规则解决。 在
.claude/settings.json里把npm test、git status这类可信命令加进允许列表，比每次都点"同意"更靠谱。
要说明的是：Manual 模式下它依然可以读，因为读不改变任何东西。真正的闸门在"写"和"执行"。
让它先理解你的项目
每次会话都是新的上下文窗口，它不会记得你上次说过什么。要让它少犯重复的错，靠两个机制：
/init：让它分析代码库，生成一份初始CLAUDE.md（构建命令、测试方式、项目约定）。/context：查看当前上下文都被什么占用了——包括哪些CLAUDE.md真的被加载了。
CLAUDE.md 是本系列第二篇的主题，这里先记住一条：它是每次会话都会加载的常驻上下文，所以要短、要具体。官方给的参考线是控制在 200 行以内。
模型与成本直觉
会话中可以用 /model 切换模型。粗略地说：日常编码用 Sonnet 这类够用，遇到架构级抉择、复杂重构再上更强的模型。不要所有事都用最贵的那个。
成本意识从第一天就该有：上下文越长，每次请求越贵；把大段无关输出塞进会话，既费钱又会让它变笨。这个话题后面单独讲。
三个常见误区
- 把它当自动补全。 它不适合"边打边猜你要写什么"；它擅长的是"这个任务交给你"。
- 一次给一个巨型需求。 越大的目标越要先
plan，让方案可审查，再让它执行。 - 不看 diff 就合并。 它写得快，不代表写得对。生成的代码该 review 还是要 review，该跑测试还是要跑测试。
小结
- Claude Code 是终端里的连续行动代理，核心是「收集→行动→验证」的循环。
- 第一次就用真实小任务，先
plan或 Manual 模式核对理解。 - 记住三个键：
Esc打断、Esc Esc回退、Shift+Tab切权限。 - 用
/init和CLAUDE.md把项目知识沉淀下来，别指望它跨会话记得。
下一篇我们专门讲 CLAUDE.md：怎么写出它真正会遵守的指令，以及为什么"在 CLAUDE.md 里写不要动 .env"这种写法根本挡不住事。