Claude Code 是什么？新手从零开始的安装与使用完整指南

Claude Code 是什么？新手从零开始的安装与使用完整指南

Claude Code 是 Anthropic 推出的 AI 编程工具，可以在终端、代码编辑器（VS Code、JetBrains 等 IDE）、桌面应用以及浏览器里使用。 它能读懂你的整个项目，同时修改多个文件，运行命令，操作 git，还能连接你正在用的各种工具。你只需用普通的话描述要做的事，Claude Code 就会制定计划、编写代码并检查结果。

本文从基本概念讲起，依次介绍安装方法、第一次运行、主要功能和安全使用技巧。所有技术信息均来自 Anthropic 的官方文档。

💻 Claude Code 是什么？

根据官方文档，Claude Code 是一款智能体式编程工具（agentic coding tool）。这里的"智能体"意思是，AI 不只是回答问题，还会自己动手：自己打开文件阅读，自己改代码，自己运行命令做检查，然后向你汇报。

你可以把 Claude Code 想象成坐在你旁边的一位程序员同事。你说"帮我修一下注册表单留空也能提交的问题"，它会自己找到相关代码、理解上下文、写出修复方案，如果项目里有现成的测试，还会运行测试。

Claude Code 可以在多个地方使用，这些地方被称为"界面"（surface）：

  • 终端：功能最完整的版本，通过命令行使用。
  • VS Code 和 Cursor：扩展插件，直接在编辑器里查看代码改动。
  • JetBrains：适用于 IntelliJ IDEA、PyCharm、WebStorm 等同系列 IDE 的插件。
  • 桌面应用：不用打开终端也能使用 Claude Code。
  • 网页浏览器：访问 claude.ai/code，电脑上什么都不用装。

好处是，这些界面在底层共用同一套"引擎"。项目的说明文件 CLAUDE.md、各项设置以及 MCP 连接，在哪里用都一样。

🤔 Claude Code 和 AI 聊天机器人有什么不同？

很多人以为 Claude Code 只是"给程序员用的 ChatGPT"。其实区别很大。

用普通聊天机器人时，你得把代码复制到对话框，读完回答，再把代码复制回来粘贴到文件里。聊天机器人看不到你的项目，也不知道文件之间有什么关系。

Claude Code 则不同：

  • 自己读项目：官方文档写得很清楚，Claude Code 会在需要时自己读取项目文件，你不用手动粘贴上下文。
  • 同时修改多个文件：一个需求可能牵涉到好几个文件的改动。
  • 自己运行命令：运行测试、安装依赖库、查看错误日志。
  • 操作 git：查看哪些文件改过、编写提交说明、新建分支、创建拉取请求（pull request）。
  • 连接外部工具：通过 MCP，它可以读取 Google Drive 上的文档、更新 Jira 工单、从 Slack 获取数据。

简单说：聊天机器人是顾问，而 Claude Code 是在你项目里真正干活的人。

🛠️ 安装 Claude Code

安装之前，你需要一个合适的账号。 根据官方文档，Claude Code 需要 Pro、Max、Team、Enterprise 套餐，或 Console 账号（按 API 用量预付费）。免费的 claude.ai 套餐不包含 Claude Code。

电脑需要满足：

  • macOS 13.0 及以上、Windows 10 版本 1809 及以上、Ubuntu 20.04 及以上、Debian 10 及以上，或 Alpine Linux 3.19 及以上。
  • 内存 4 GB 及以上。
  • 能连接互联网。

推荐的安装方式是原生安装（Native Install）。打开终端，运行与你的系统对应的命令。

在 macOS、Linux 或 WSL 上：

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

在 Windows PowerShell 上：

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

在 Windows CMD 上：

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

原生安装版会在后台自动更新，让你始终用上最新版本。如果你更习惯用包管理器，也可以通过 Homebrew 或 WinGet 安装（这两种方式不会自动更新，需要你定期手动升级）：

brew install --cask claude-code

winget install Anthropic.ClaudeCode

装好后，打开一个新的终端窗口，然后检查：

claude --version

如果屏幕上显示出版本号并带有"(Claude Code)"字样，就说明安装成功了。如果终端提示找不到 claude 命令，说明安装目录还没加入系统路径（PATH）。Anthropic 的故障排查页面有详细的解决方法。你也可以运行 claude doctor，让它自动检查安装状态。

几点小提示：

  • 在 Windows 上，文档建议额外安装 Git for Windows，这样 Claude Code 才能使用 Bash 工具。没有它的话，Claude Code 会改用 PowerShell。
  • 用 npm 安装的方式仍然可用，但被列在高级选项里，而且需要 Node.js 22 及以上版本。新手建议用上面的原生安装。
  • 不喜欢终端？你可以下载桌面应用，或者在 VS Code 里安装 Claude Code 扩展。两者都提供更直观、更熟悉的界面。

🚀 第一次运行

在你想要处理的项目文件夹里打开终端，然后输入 claude：

cd path-to-your-project
claude

第一次运行时，Claude Code 会要求你登录。按提示操作，浏览器会打开页面让你验证账号。登录一次就行，之后不用再登录。想切换账号的话，在会话中输入 /login 即可。

进入后，你会看到 Claude Code 的输入提示符，上方显示版本、当前使用的模型和当前文件夹。先问几个问题，让 Claude 熟悉项目。官方文档推荐这样的问题：

  • "what does this project do?"（这个项目是做什么的？）
  • "explain the folder structure"（解释一下文件夹结构）
  • "where is the main entry point?"（程序的主入口在哪里？）

你完全可以用中文提问。接着试一个小改动，Claude 会找到正确的文件，并把改动展示给你看。

几个值得记住的基本命令：

  • claude：打开一个会话。
  • claude -c：继续这个文件夹里最近一次的对话。
  • claude -p "你的问题"：问一次就退出，适合写脚本。
  • /help：查看可用命令列表。
  • /clear：清空对话历史，开始新任务。
  • /exit：退出 Claude Code。

🧩 Claude Code 的主要功能

正是这些功能，让 Claude Code 从"懂代码的助手"变成"懂你意思的助手"。每个功能我都简单解释一下，并附上详细文章，方便你深入了解。

1. CLAUDE.md：项目手册。 这是放在项目根目录的一个文本文件，Claude Code 会在每次会话开始时读取它。你可以在里面写项目的运行命令、代码规范，以及"必须始终遵守"的事项。输入 /init，Claude 会自动分析项目并生成一份 CLAUDE.md 初稿。文档建议把这个文件控制在 200 行以内，这样 Claude 执行得更好。延伸阅读：如何写 CLAUDE.md，让 Claude 读懂你的项目。

2. 权限模式：由你决定 Claude 可以自己做什么。 Claude Code 有多种模式，例如：Manual（大多数改文件、运行命令的操作都会先问你）、acceptEdits（自己改文件，其他事情才问你）、plan（只读代码、做计划，暂不修改）、auto（由一个辅助模型替你做安全检查）。随时按 Shift+Tab 切换模式。详见文章 Claude Code 的权限模式。

3. 斜杠命令：以 / 开头的快捷命令。 输入 / 就能看到所有可用的命令和技能。你还可以为经常重复的事情创建自己的命令。教程：只用一个文件，创建你自己的斜杠命令。

4. Skills：可复用的流程包。 Skill 是为某一类任务预先打包好的一套说明，比如"审查拉取请求"或"部署到测试环境"。和始终被加载的 CLAUDE.md 不同，skill 只在你调用它，或 Claude 判断它相关时才会加载。详见文章 Claude Code Skills 让 AI 更符合你的心意。

5. Hooks：在恰当的时刻自动运行命令。 Hook 可以在 Claude 执行某个动作之前或之后运行一条命令，比如每次改完文件就自动格式化代码，或者在提交前运行检查。重点是：CLAUDE.md 只是叮嘱，而 hook 一定会运行，不管 Claude 怎么决定。延伸阅读：用 hooks 把终端变成自动化机器。

6. MCP：连接外部工具的接口。 MCP（Model Context Protocol，模型上下文协议）是一个开放标准，让 AI 能连接其他数据源和工具。有了 MCP，Claude Code 就能和 Google Drive、Jira、Slack 或你公司的内部工具一起工作。如果你是第一次听说，可以先读 MCP 是什么，Claude 如何连接各种工具。

7. 子智能体：专业助手团队。 Claude Code 可以创建多个子智能体，并行处理一项大任务的不同部分，由主智能体负责协调和汇总结果。你也可以为不同角色自定义专门的智能体。教程：用 .claude/agents 文件夹创建专用子智能体。

🎯 可以让 Claude Code 帮你做的事

官方文档列出了很多实际用例。下面是最容易上手的几类：

  • 看懂一个陌生项目："解释一下这个项目是做什么的，主要的文件夹分别用来干什么"。
  • 修 bug：贴上报错信息或描述现象，Claude 会顺着代码追查，找到根本原因并修复。
  • 开发新功能："给用户注册表单加上输入数据校验"。
  • 写测试："为登录模块写测试，运行一下，哪里出错就修哪里"。
  • 整理代码：修复整个项目的格式问题、升级依赖库、解决合并代码时的冲突。
  • 操作 git："用清晰的说明提交这些改动"、"新建一个叫 feature/quickstart 的分支"。
  • 安排定期任务：Claude Code 有在云端运行的 Routines，即使你的电脑关机也能照常工作，适合每天早上审查拉取请求这类任务。

💡 高效又安全地使用 Claude Code 的技巧

说得具体一点。 与其说"修一下 bug"，不如写"修复登录问题：用户输错密码后看到白屏"。要求越清楚，结果越贴近。

把大任务拆成小步骤。 例如：第 1 步建数据表，第 2 步写 API，第 3 步做界面。

先让 Claude 了解情况再动手。 对重要的任务，打开 plan 模式，让 Claude 先读代码、提出计划。你审核通过后，再让它开始修改。

把经常要提醒的事写进 CLAUDE.md。 文档建议：当 Claude 第二次犯同一个错误，或者你不得不重复上一次会话里说过的叮嘱时，就该把它加进 CLAUDE.md 了。

选择合适的权限模式。 处理敏感任务时，用 Manual 模式亲自审核每一个操作。bypassPermissions 模式会跳过所有检查，官方文档只建议在隔离的容器或虚拟机里使用，千万不要在你的主力工作电脑上打开。

把 git 当作安全网。 经常提交，这样如果 Claude 改得不合心意，你随时都有可以退回的节点。

还想更快？可以看看 5 个少有人知的 Claude Code 技巧，让速度翻倍。

❓ 常见问题

Claude Code 免费吗？ 不免费。根据官方文档，你需要 Pro、Max、Team、Enterprise 套餐或 Console 账号。免费的 claude.ai 套餐不包含 Claude Code。

不会编程能用 Claude Code 吗？ 能。你用自然语言和它交流，中文也可以。如果不习惯终端，可以用桌面应用或 VS Code 扩展，界面更直观。

Claude Code 能在 Windows 上运行吗？ 能。你可以通过 PowerShell 或 CMD 直接安装在 Windows 10（版本 1809 及以上）上，也可以装在 WSL 里。建议额外安装 Git for Windows，以便使用 Bash 工具。

Claude Code 会擅自修改我的代码吗？ 这取决于你选择的权限模式。在 Manual 模式下，大多数改文件或运行命令的操作，Claude 都会先问你。随时按 Shift+Tab 切换模式。

怎样让 Claude Code 记住项目的规则？ 在项目根目录创建 CLAUDE.md 文件，或者输入 /init 让 Claude 生成初稿。Claude 会在每次会话开始时读取这个文件。此外，自动记忆（auto memory）功能也能让 Claude 自己记住你纠正过的地方。

准备好输入你的第一条 claude 命令了吗？如果卡在哪一步，直接问 Claude Code"怎么才能……"，关于它自己的问题它也能回答。

更多文章