第03章 安装、登录与第一条有效指令

Claude Code 的入门门槛不在安装，而在第一次使用时能不能把它当成“会操作工具的开发者”，而不是一个聊天窗口。

最小可用路径是：安装 CLI、进入项目、让它读懂仓库、确认权限边界、再交给它一个足够具体的小任务。

安装方式

官方推荐的原生安装方式会自动保持更新：

curl -fsSL https://claude.ai/install.sh | bash

macOS 也可以用 Homebrew：

brew install --cask claude-code

Windows 可以使用 PowerShell 安装脚本，或者通过 WinGet 安装：

irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode

安装后进入任意项目：

cd your-project
claude

如果你使用 Anthropic Console API Key，可以按官方登录流程配置；如果你使用 Claude 订阅，也可以在交互界面中 /login。

第一次进入项目

不要一上来就说“帮我重构这个项目”。第一次会话应该让 Claude Code 先建立项目地图：

这个项目是做什么的？请阅读 README、主要入口文件和配置文件，
总结架构、启动方式、测试方式，以及你认为最重要的 5 个文件。
暂时不要修改任何文件。

这条指令有三个好处：

1. 明确允许它读文件。
2. 明确禁止它写文件。
3. 让它把项目启动方式、测试方式、关键文件先说清楚。

如果项目还没有 CLAUDE.md，可以运行：

/init

CLAUDE.md 是 Claude Code 的项目记忆文件，适合写入项目结构、常用命令、测试规则、代码风格和发布约束。它不是给人看的长篇 README，而是给代理执行任务时反复读取的操作说明。

权限模型要先设好

Claude Code 能读文件、改文件、执行 Bash 命令。能力越强，越需要权限边界。

入门阶段建议使用三条规则：

• 读文件、搜索代码可以放开。
• 写文件、运行测试需要确认。
• 删除文件、发布、改环境变量、访问生产服务必须手动确认。

进入会话后可以用：

/permissions

管理 allow、ask、deny 规则。对新手来说，最重要的不是把提示框全部消掉，而是知道哪些操作会造成真实副作用。

第一条真正有效的任务

入门任务要足够小，最好满足三个条件：范围明确、可验证、低风险。

例如：

请找出这个项目里所有和登录相关的 TODO，按文件路径分组，
判断哪些是注释债务、哪些可能影响功能。不要修改文件。

或者：

请阅读最近一次 git diff，帮我做一次代码审查。
只列出真实风险，不要评价风格问题，也不要修改文件。

当你确认它的判断靠谱后，再把任务升级成可执行：

请修复你刚才指出的第 1 个问题。修改后运行对应测试。
如果没有现成测试，说明你验证了什么。

初学者最常见的错误

第一个错误是把 Claude Code 当问答工具，只让它“告诉我怎么做”。正确方式是给它目标、边界和验证标准，让它直接操作项目。

第二个错误是一次性给太大的任务。Claude Code 可以做大任务，但新项目、新会话、新用户组合在一起时，最好先从小任务建立信任。

第三个错误是忽略上下文维护。会话变长后，用：

/context
/compact

检查上下文占用并压缩历史。不要等到上下文溢出才处理。

本章小结

Claude Code 入门的关键不是记命令，而是建立“可委托任务”的写法：

目标 + 范围 + 权限边界 + 验证方式

当你能稳定写出这种指令，Claude Code 才会从聊天助手变成真正的开发伙伴。

参考资料：

• Claude Code Overview
• Claude Code Commands