它是什么

Claude Code 是 Anthropic 的命令行编程 Agent。你可以在项目目录中启动它，用自然语言提出编程任务，例如理解代码、分析问题或修改功能。

使用时，重点是把目标、范围和验收条件说清楚。把它当作需要交代上下文的协作者，比只说一句“帮我优化项目”更容易得到可检查的结果。生成的解释和代码仍需人工审查。

适合谁

它适合需要阅读陌生项目、处理日常开发任务，以及希望减少重复操作的开发者。初学者也可以用它辅助理解代码，但应先弄清建议，再决定是否采用。

使用前，需要准备以下任一种账号或接入条件：

  • Claude 订阅：Pro、Max、Ultra、Team、Enterprise。
  • Claude Console 账号，使用预付费 API。
  • 受支持的云服务商。

账号可用范围、费用和接入细节以官方文档为准。不要把“安装成功”理解成已经获得使用额度。

安装：按系统选择方式

选择与你的操作系统和终端对应的一种方式即可。初次安装建议只采用一种，方便后续确认版本和维护更新。

macOS、Linux 与 WSL

在终端运行：

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

这是原生安装方式，安装后会在后台自动更新。

macOS 用户也可以通过 Homebrew 安装：

brew install --cask claude-code

该方式使用 stable 渠道，通常约晚一周；claude-code@latest 为最新渠道，具体选择方式以官方文档为准。

Homebrew 默认不会自动更新 Claude Code，需要更新时运行：

brew upgrade claude-code

Windows

如果使用 PowerShell，运行：

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

如果使用 CMD，运行：

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

以上属于原生安装方式，会在后台自动更新。请区分终端类型，不要把 PowerShell 的安装命令直接复制到 CMD。

也可以使用 WinGet：

winget install Anthropic.ClaudeCode

WinGet 默认不会自动更新 Claude Code，需要更新时运行：

winget upgrade Anthropic.ClaudeCode

检查安装结果

安装完成后，查看版本：

claude --version

如果安装或运行出现问题，可以执行诊断：

claude doctor

先记录报错和诊断结果，再判断下一步。其他系统要求和故障处理细节以官方文档为准，不建议反复混用不同安装方式。

首次登录与配置

先进入准备处理的项目目录，再运行：

claude

首次启动会提示登录，按照提示在浏览器中完成认证。

如果已经设置了 ANTHROPIC_API_KEY，并同意使用该密钥，则会跳过登录。环境变量的设置方法以官方文档为准。使用前应确认密钥所属账号，以及是否准备通过该账号使用 API。

进入会话后，可以用以下命令获得帮助或管理对话：

  • /help：查看命令。
  • /resume：继续之前的对话。
  • /login：切换账号。

第一次使用建议先完成一个小任务，确认登录和基本交互正常，再逐步增加配置。

上手示例：把任务说具体

先理解项目

面对陌生代码，可以这样提出任务：

请介绍这个项目的主要目录、程序入口和核心模块。先只阅读和解释，不修改文件；无法确认的地方请明确指出。

这种任务便于检查它是否理解项目，也能帮助你决定下一步该看哪里。

再定位问题

遇到异常时，尽量提供复现条件：

提交空表单时页面出现异常。请检查相关校验逻辑，说明可能原因和需要补充的信息。先给出修改建议，等我确认后再改。

尽量附上实际现象和预期行为。不要只说“这里有问题”，也不要要求它在信息不足时直接猜测原因。

最后尝试小范围修改

选择一个容易验收的任务：

请为这个函数补充边界情况测试，只修改相关测试文件。完成后说明覆盖了哪些情况、执行了哪些检查，以及是否还有未验证的部分。

检查结果时，要区分“建议执行的检查”和“已经执行的检查”。不能仅凭回答中出现“完成”就认定任务通过。

实用技巧与安全注意

分步推进。 复杂任务可以拆成理解、方案、修改和验证几个阶段。每次明确允许修改的范围，发现方向不对时及时纠正。

提供必要上下文。 说明项目约束、期望行为和验收标准，避免一次粘贴大量无关内容。继续旧任务时可用 /resume，同时补充期间发生的变化。

按需扩展。 Claude Code 可以通过 CLAUDE.md、skills、hooks、MCP 扩展。先把基本流程用顺，再根据实际需求引入；具体配置和行为以官方文档为准。

保护敏感信息。 不要在任务描述中粘贴密码、密钥或真实客户数据。安装命令涉及下载并执行脚本，运行前应核对地址，避免使用来源不明的替代命令。

保留检查与恢复空间。 修改前保留可恢复的项目状态，修改后审查差异。涉及删除文件、外部服务或重要数据时，应明确要求先解释影响，再由你决定是否执行。

小结

Claude Code 的入门路径是：选择安装方式、检查安装结果、进入项目登录，再用一个小任务熟悉协作过程。真正影响使用效果的，是清楚的任务描述、适当的修改范围，以及对结果的认真验证。

官方链接

命令与版本核对于 2026-11-03，产品迭代较快，请以官方文档为准。