目标:在大约 15 分钟内,您将安装 Claude Code、登录并完成您的第一个 AI 辅助更改。本指南仅涵盖第一天所需的内容;更深入的材料链接出现在末尾。
步骤 1:安装 Claude Code(2 分钟)
选择与您的机器匹配的命令,并将其粘贴到终端中。
您的设置 | 命令 |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
提示:不要使用 sudo 运行 npm install,因为这会导致后续文件权限问题。
验证安装:
claude --version
步骤 2:登录(2 分钟)
您的身份验证方式取决于您的组织如何配置访问权限。选择以下选项之一:
如果您的组织使用… | 执行此操作 |
Claude Enterprise 席位 | 运行 |
Anthropic Console API 密钥 | 运行 |
Amazon Bedrock | 运行 |
Google Vertex AI | 运行 |
如果您不确定适用哪种方法,请咨询您的管理员或先尝试 /login,这是大多数组织的默认方式。
步骤 3:打开项目(1 分钟)
cd path/to/your/project claude
Claude Code 按需读取您的文件,因此无需上传或附加任何内容。只需从您要处理的存储库内启动它。
步骤 4:了解唯一的安全规则(1 分钟)
Claude 将始终在更改文件或运行命令之前询问。当它提议更改时,您将看到一个差异和三个选择:
是 — 应用此单个更改。
是,以后不再询问编辑 — 在会话的剩余时间内自动批准文件编辑。
否 — 拒绝更改并解释原因。
您可以随时按 Shift+Tab 在模式之间循环(计划 → 接受编辑 → 默认)。如果更改产生意外结果,您的 git 历史记录在您提交之前保持不变,因此 git checkout 将撤销它。
步骤 5:首先尝试的五件事
将这些逐个复制并粘贴到提示中。每个示例演示了一个不同的核心功能。
1. 了解方向
Give me a 5-bullet summary of what this codebase does and where the entry point is.
为什么这很有用:它展示了 Claude 如何自行探索文件,而无需指向特定路径。
2. 查找内容
Where is user authentication handled? Show me the file and the key function.
为什么这很有用:当您不知道确切的符号或文件名时,它通常比 grep 更快。
3. 进行安全编辑
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
为什么这很有用:它让您可以在低风险更改上练习审查和批准差异。
4. 修复真实问题
This test is failing: <paste the error>. Find the cause and fix it.
为什么这很有用:这是主要工作流程 — 您描述症状,Claude 调查并提议修复。
5. 让它处理 git
Stage my changes and write a commit message that follows our existing style.
为什么这很有用:Claude 可以代表您运行 git(经过批准),并将匹配您的存储库的现有提交约定。
步骤 6:在您结束一天之前
每个项目运行一次:
/init
这会在您的项目根目录生成一个 CLAUDE.md 文件,该文件捕获您的代码库的约定。Claude 在每个会话开始时自动读取它,因此未来的响应将已针对您的项目进行定制。这是您可以采取的单一最高价值的设置步骤。
后续步骤
您现在已安装 Claude Code、进行了身份验证、进行了编辑并设置了项目内存。当您准备进一步了解时,官方文档涵盖了内存和 CLAUDE.md、斜杠命令和交互模式快捷键的深入内容。
如果您在安装或登录期间遇到问题,请参阅故障排除指南。
