安装 Claude Code 并在终端完成第一次代码修改

Claude Code 是一个跑在终端里的智能体式编程工具。它不需要你手动把文件内容贴进对话框，而是自己按需读取项目文件、理解目录结构，然后直接给出改动建议或执行命令。这篇教程面向第一次接触它的开发者，目标很具体：把 CLI 装好、登录成功、在你自己真实存在的项目里完成一次代码修改，并且知道日常该用哪几个命令。如果你更习惯图形界面，站内也有对应的工具说明页可以参考：Claude Code。

需要先说明一点：Claude Code 并不是一个纯本地工具。默认配置下，它需要能访问 claude.ai 与 Anthropic API 等端点，才能完成安装、登录和正常使用。所以在动手之前，先确认你所在网络环境能够连通这些服务；如果走企业代理，或者通过 Amazon Bedrock 这类第三方云服务商接入，网络要求会不一样，需要单独配置。这一步没确认好，后面安装和登录都会卡住。

准备工作

开始之前，请逐项确认下面这些条件：

一个可以正常使用的终端或命令提示符窗口。
一个你手头真实存在的代码项目，用来做练习。空目录也能启动，但读不到东西，体验不到它的价值。
一种可用的账户或访问方式，三选一即可：Claude 订阅（Pro、Max、Ultra、Team 或 Enterprise）、Claude Console 账户（使用预付额度的 API 访问），或者通过受支持的云服务商获得的访问权限。
如果你所在组织部署了自托管的 Claude apps gateway，管理员会预先配置好网关地址，登录时会直接打开 Cloud gateway 界面，走企业 SSO 认证。

如果你此前完全没有用过终端，建议先花几分钟熟悉如何打开终端、如何粘贴命令，再回来继续。Claude Code 除了终端形态，也提供网页、桌面应用、VS Code 与 JetBrains IDE 插件、Slack 集成，以及通过 GitHub Actions 和 GitLab 在 CI/CD 中运行的方式。这篇只讲终端 CLI 这一条路径。

关于订阅档位、可用模型和配额的具体内容，各版本之间变化较快，请以官网当前信息为准，本文不列具体数字。

操作步骤

步骤 1：安装 Claude Code

打开终端，按你的操作系统选择对应命令。官方推荐的是原生安装方式，它会自动在后台更新，让你始终用上较新的版本。

macOS、Linux、WSL 使用原生安装脚本：

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

Windows PowerShell 使用：

irm https://claude.ai/install.ps1 | iex

Windows CMD 使用：

curl -fsSL -o install.cmd https://claude.ai/install.cmd && install.cmd && del install.cmd

在 Windows 上要分清自己当前在哪个 shell 里：PowerShell 的提示符形如 PS C:\，CMD 的提示符形如 C:\，没有 PS 前缀。如果提示 The token '&&' is not a valid statement separator，说明你在 PowerShell 里却用了 CMD 的命令；如果提示 'irm' is not recognized as an internal or external command，说明你在 CMD 里却用了 PowerShell 的命令。换到正确的窗口重试即可。

原生安装过程中不会显示下载进度，看起来像卡住了，耐心等它结束就好。安装完成后，新开一个终端窗口，运行：

claude --version

正常安装会打印一个版本号，后面跟着 (Claude Code)。如果 shell 提示找不到 claude 或无法识别该命令，说明安装目录还没有加入 PATH，需要手动修复 PATH 后再试。

如果安装命令报出 syntax error near unexpected token '<'、403 或其他错误，属于安装环节的常见问题，可以对照错误信息查找对应的修复方案，或改用下面的替代安装方式。

Homebrew（macOS）：

brew install --cask claude-code

Homebrew 提供两个 cask。claude-code 跟踪稳定发布渠道，通常比最新版本晚约一周，并且会跳过有重大回归的版本；claude-code@latest 跟踪最新渠道，新版本一发布就立即接收。需要注意，Homebrew 安装不会自动更新，需要定期手动执行 brew upgrade claude-code 或 brew upgrade claude-code@latest（取决于你装的是哪个 cask）来获取新功能和安全修复。

WinGet（Windows）：

winget install Anthropic.ClaudeCode

WinGet 安装同样不会自动更新，需要定期运行 winget upgrade Anthropic.ClaudeCode。

此外，在 Debian、Fedora、RHEL 和 Alpine 上也可以通过 apt、dnf 或 apk 安装。安装完成后统一用 claude --version 验证。

如果你在原生 Windows 上使用，建议同时安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具。没有安装 Git for Windows 时，它会退而使用 PowerShell 作为 shell 工具。WSL 环境不需要 Git for Windows。

步骤 2：启动第一个会话并登录

进入你的项目目录，然后启动 Claude Code：

cd /path/to/your/project
claude

把 /path/to/your/project 换成你实际的项目路径。首次使用时，Claude Code 会提示你登录，按提示在浏览器中完成身份验证即可。如果你已经设置了 ANTHROPIC_API_KEY 环境变量，并且在它询问是否使用该密钥时选择批准，就会跳过登录提示。

首次登录时，系统会在 Console 中自动创建一个名为 “Claude Code” 的工作区，用于集中跟踪费用。登录成功后凭据会被保存，之后不需要反复登录。如果之后想切换账户或重新认证，在运行中的会话里输入 /login 即可。

登录完成后会出现 Claude Code 提示符，上方显示版本、当前模型和工作目录。此时输入 /help 可以查看可用命令，输入 /resume 可以继续之前的对话。

步骤 3：让 Claude 读懂你的项目

先不要急着让它改代码。第一步是让它理解项目，这能显著提高后续改动的准确度。在提示符下直接输入自然语言：

what does this project do?

Claude 会分析你的文件并给出摘要。你也可以问得更具体：

what technologies does this project use?
where is the main entry point?
explain the folder structure

它还会根据需要自行读取项目文件，你不需要手动把上下文贴进去。除了项目本身，你也可以问它关于自身能力的问题，例如它能做什么、如何创建自定义 skill、能否与 Docker 配合使用。

步骤 4：完成第一次代码修改

从一个小任务开始，比如：

add a hello world function to the main file

Claude Code 会自己找到合适的文件，并把改动展示给你。如果它在动手前征求确认，选择 Yes 批准即可。会话的权限模式决定了 Claude 可以在不事先询问你的情况下执行哪些操作，随时按 Shift+Tab 可以切换当前会话的权限模式。刚上手时建议保持较保守的模式，看清它每一步在做什么。

步骤 5：用对话完成 Git 操作

Git 操作在 Claude Code 里可以像聊天一样完成：

what files have I changed?
commit my changes with a descriptive message

更复杂的操作同样可以用提示词表达：

create a new branch called feature/quickstart
show me the last 5 commits
help me resolve merge conflicts

步骤 6：修复 bug 或添加功能

用自然语言描述你想要的结果，而不是描述实现方式。添加功能可以这样写：

add input validation to the user registration form

修复已有问题则把现象说清楚：

there's a bug where users can submit empty forms - fix it

步骤 7：尝试其他常见工作流

熟悉基本操作后，可以继续让它重构代码、编写测试、更新文档或审查改动：

refactor the authentication module to use async/await instead of callbacks
write unit tests for the calculator functions
update the README with installation instructions
review my changes and suggest improvements

整体思路是把它当成一位乐于配合的同事：说清楚你想达成什么目标，剩下的交给它去想办法。

一个完整示例

下面把前面的步骤串成一条完整流程，假设你有一个名为 shop-api 的项目，位于 ~/work/shop-api，并且已经完成安装。

第一步，进入项目并启动。

cd ~/work/shop-api
claude

首次运行会走登录流程，浏览器认证完成后回到终端，看到提示符和版本、模型、工作目录信息。

第二步，先让它摸清项目。

what does this project do?
where is the main entry point?

阅读它给出的摘要，确认它理解的结构和你认知一致。如果它说错了，直接纠正它，比后面改错代码再回滚省事得多。

第三步，提出一个范围明确的小改动。

add input validation to the user registration form

它会定位到注册表单相关的文件，展示改动内容。如果当前权限模式要求确认，选择 Yes 批准。

第四步，检查并提交。

what files have I changed?
commit my changes with a descriptive message

先看它列出的改动文件列表，确认没有误改无关文件，再让它生成提交信息并提交。

第五步，退出。

输入 /exit，或连续按两次 Ctrl+D。

如果中途想换一个话题重新开始，用 /clear 开启新对话；之前的对话之后仍可通过 /resume 恢复。如果只是想临时问一句、不想进入交互模式，可以在终端里用一次性查询：

claude -p "explain this function"

这条命令执行完就退出，适合脚本化或快速确认场景。

日常命令速查

下面这些命令按运行位置分成两组，是日常使用频率最高的部分。

Shell 命令（在终端里运行，用于启动或恢复 Claude Code）：

命令	功能	示例
`claude`	启动交互模式	`claude`
`claude "task"`	带初始提示启动交互模式	`claude "fix the build error"`
`claude -p "query"`	运行一次性查询后退出	`claude -p "explain this function"`
`claude -c`	在当前目录继续最近的对话	`claude -c`
`claude -r`	恢复之前的对话	`claude -r`

会话命令（在 Claude Code 启动之后，于其内部输入）：

命令	功能	示例
`/clear`	开始新对话，旧对话可用 `/resume` 恢复	`/clear`
`/help`	显示可用命令	`/help`
`/exit` 或两次 `Ctrl+D`	退出 Claude Code	`/exit`
`/login`	切换账户或重新认证	`/login`
`/resume`	继续之前的对话	`/resume`

几个能明显省时间的快捷键：输入 / 查看所有命令和 skills，用 Tab 做命令补全，按 ↑ 翻命令历史，按 Shift+Tab 循环切换权限模式。

注意事项

网络连通性是前提。默认配置下 Claude Code 需要访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录与正常使用。在中国大陆的网络环境中，这些端点可能无法直接访问，动手前先确认网络状况。企业代理和 Amazon Bedrock 等第三方提供商的网络要求另有规定，需要单独配置。

安装后必须新开终端窗口。原生安装脚本执行期间不显示进度，装完后要在新窗口里运行 claude --version 验证。如果提示找不到命令，问题出在 PATH 上，而不是安装失败。

更新策略因安装方式而异。原生安装会在后台自动更新；Homebrew 和 WinGet 安装都不会自动更新，需要定期手动升级，否则会错过新功能和安全修复。Homebrew 的稳定渠道通常比最新渠道晚约一周，并会跳过有重大回归的版本，追求稳定可以选它，想第一时间用新特性则选 claude-code@latest。

Windows 上的 shell 选择。建议在原生 Windows 上安装 Git for Windows，让 Claude Code 使用 Bash 工具；未安装时它会改用 PowerShell 作为 shell 工具。WSL 环境不需要这一项。

权限模式决定它会不会先问你。会话的权限模式控制 Claude 可以在不询问你的情况下执行哪些操作，按 Shift+Tab 切换。在真实项目里操作时，先看清当前模式，再让它动代码。

提示词越具体，结果越可控。不要只说“修复错误”，而要说“修复登录错误，用户输入错误凭证后看到空白屏幕”。复杂任务拆成分步说明，例如先创建数据库表、再创建 API 端点、最后构建页面。在让它改代码之前，先让它分析并理解现有结构。

账户与计费。首次登录会在 Console 中自动创建 “Claude Code” 工作区用于集中跟踪费用。订阅档位、模型可用性、配额与计费规则会随时间调整，请以官网当前信息为准。