Claude Code CLI 入门指南：从安装到你的第一个 AI 编程任务
入门15 分钟阅读
Claude Code CLI 入门指南：从安装到你的第一个 AI 编程任务

Claude Code CLI 入门指南：从安装到你的第一个 AI 编程任务

CATAITO Team2026-08-07
你的操作系统:

本教程教你什么

Claude Code 是 Anthropic 推出的 AI 编程代理，直接运行在你的终端中。它可以读取你的项目、编辑文件、运行命令、自动化开发任务——全部在命令行里完成。学完本教程，你将能够安装 Claude Code、登录账号，并完成你的第一个 AI 辅助编程任务。

本篇覆盖哪个版本？ 本教程只覆盖 Claude Code CLI——在终端中运行的版本。不涉及桌面应用或网页版。如果你想要图形界面的桌面版，请查阅专门的桌面版教程。

所需时间： 15–20 分钟

难度： 初级

开始之前

要求说明
操作系统macOS 13 或更高、Windows 10 1809 或更高、或 Linux（Ubuntu 20.04+、Debian 10+、Alpine 3.19+）
账号Claude Pro、Max、Team 或 Enterprise 订阅，或 Claude Console 账号（按量付费）
终端PowerShell（Windows）、终端（macOS）或你的 Linux 终端
硬件至少 4 GB 内存
费用Claude 订阅（Pro 每月 $20 起），或按 API 用量付费

什么是终端？ 终端（也叫命令行）是一个通过输入命令来操作电脑的窗口，而不是点击按钮。在 Windows 上它叫 PowerShell；在 macOS 上它叫 终端。本教程使用 claude 命令，你需要把它输入到这个窗口中并按回车。

什么是 Claude Code？ Claude Code 是 Anthropic 推出的编程代理。它读取你的文件，理解项目中各部分之间的关联，可以自行编辑多个文件、运行测试、修复错误——但会在执行前征求你的许可。

什么是 API key？ API key（API 密钥）是一串识别你账号身份的秘密切码，用于按量付费。你可以在 Claude Console（console.anthropic.com）中生成一次。请像对待密码一样对待它——绝不要分享给别人。

如何打开终端（逐步操作）

如果你不确定如何打开终端，请按下面你所用系统的步骤操作。本教程中的每条命令都要在终端里使用。

Windows — 打开 PowerShell

  1. 1点击屏幕左下角的开始按钮（Windows 徽标）。
  2. 2直接输入 PowerShell——不需要先点击任何东西，直接开始打字。
  3. 3点击列表中出现的 Windows PowerShell 或 终端 应用。
  • Windows 11 显示终端；Windows 10 显示 Windows PowerShell。两者都可以。
  1. 1如果弹出蓝色的用户账户控制窗口，点击是。

如何粘贴命令： 在 PowerShell 窗口内任意位置右键即可粘贴（或按 Ctrl + V）。

下载与安装

选择你的版本

版本适合谁说明
原生安装器（推荐）大多数用户经过完整测试，推荐使用；后台自动更新
Homebrew已经在用 Homebrew 的 macOS 用户与其他应用一起管理；需手动更新
WinGet已经在用 WinGet 的 Windows 用户Windows 包管理器；需手动更新

什么是 Homebrew？ Homebrew 是 macOS 的免费包管理器。你输入 brew install 来安装程序，就像命令行版的应用商店。只有你已经在用 Homebrew 时才选这个选项。

什么是 WinGet？ WinGet 是 Windows 10 和 11 自带的官方包管理器。只有你已经在用它时才选这个选项。

为你的系统安装

请选择你的系统。每个标签页包含该操作系统的完整步骤。

Windows 安装

  1. 1打开 PowerShell：点击开始按钮（Windows 徽标），输入 PowerShell，然后点击 Windows PowerShell 或 终端。
  2. 2复制下面的命令，粘贴到 PowerShell 窗口中，按回车：
powershell
irm https://claude.ai/install.ps1 | iex
  1. 1等待安装完成。当你可以再次输入时，复制并运行以下命令验证安装：
powershell
claude --version

如果看到版本号后跟 (Claude Code)（例如 2.1.211 (Claude Code)），说明安装成功。

使用 CMD 而不是 PowerShell： 如果你的终端行首显示 C:\ 而没有 PS，说明你在 CMD 中。请改运行这条命令：

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

如果看到 The token '&&' is not a valid statement separator，说明你在 PowerShell 中——请用上面的 irm 命令。如果看到 'irm' is not recognized as an internal or external command，说明你在 CMD 中——请用上面的 curl 命令。

更新 Claude Code： 原生安装会自动更新。想立即检查更新，运行：

powershell
claude update

可选 — WinGet： 如果你更喜欢 WinGet 包管理器：

powershell
winget install Anthropic.ClaudeCode

用它更新：

powershell
winget upgrade Anthropic.ClaudeCode

登录

  1. 1打开终端，进入你的项目文件夹（把 path/to/your/project 换成你自己的文件夹路径）：
bash
cd path/to/your/project
  1. 1启动 Claude Code：
bash
claude
  1. 1第一次使用时，系统会要求你登录。浏览器窗口会自动打开：
  • 用你的 Claude 账号登录 —— 使用你的 Pro、Max、Team 或 Enterprise 订阅。登录后，浏览器会自动把凭证交还给 Claude Code。
  • 使用 Claude Console（API） —— 如果你更喜欢按量付费，请改用你的 Console 账号登录。
  1. 1登录完成后，你会看到 Claude Code 的提示符，准备接受你的第一个任务。登录状态会被保存，之后无需再次登录。

注意： 免费的 Claude.ai 套餐不包含 Claude Code。你需要付费订阅或 Console 账号。

安装故障排查

错误原因解决方法
claude: command not found安装文件夹不在你的 PATH 中见下方针对你系统的分步修复
'irm' is not recognized as an internal or external command你在 CMD 中运行了 PowerShell 命令改用 CMD 安装命令（curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd）
The token '&&' is not a valid statement separator你在 PowerShell 中运行了 CMD 命令改用 PowerShell 安装命令（`irm https://claude.ai/install.ps1 \iex`）
安装时出现 syntax error near unexpected token '<' 或 HTTP 403网络限制，或命令粘贴到了错误的终端类型检查网络连接，确认可以访问 claude.ai，并在正确的终端类型中重试
浏览器登录页打不开网络限制或代理检查网络连接后重试。如果你使用 VPN 或代理，尝试关闭或切换服务器
Login expired · Please run /login存储的登录已过期运行 claude，然后在会话中输入 /login 重新登录

修复"claude: command not found"——Windows：

  1. 1按 Windows 键，输入 environment variables，点击编辑系统环境变量。
  2. 2点击环境变量... 按钮。
  3. 3在下方的列表（系统变量）中找到 Path，选中它，点击编辑...。
  4. 4点击新建，添加 Claude Code 的安装文件夹（默认：C:\Users\<你的用户名>\.local\bin），然后逐个点击确定。
  5. 5完全关闭 PowerShell 后重新打开，再运行 claude --version。

修复"claude: command not found"——macOS/Linux：

  1. 1打开终端，复制运行这条命令：
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  1. 1重新加载配置：
bash
source ~/.zshrc
  1. 1如果你用的是 Bash 而不是 Zsh，把上面两条命令中的 ~/.zshrc 换成 ~/.bashrc。
  2. 2运行 claude --version 确认。

你的第一个任务

第 1 步：打开一个项目

进入你想让 Claude Code 处理的项目文件夹（把路径换成你的）：

bash
cd path/to/your/project

现在你应该能在终端提示符中看到该文件夹的路径。

第 2 步：启动 Claude Code

bash
claude

Claude Code 启动后显示提示符，其中包含版本号、当前模型和你所在的文件夹。

第 3 步：问出你的第一个问题

输入下面的请求并按回车：

text
这个项目是做什么的？

Claude Code 会读取项目文件并解释它发现了什么。再试试这几条：

  • 这个项目用了哪些技术？ —— 识别项目使用的技术栈
  • 主入口在哪里？ —— 找到主文件
  • 解释一下文件夹结构 —— 说明文件夹的组织方式

第 4 步：做出你的第一处代码修改

输入下面的请求并按回车：

text
在主文件中添加一个 hello world 函数

Claude Code 会找到正确的文件，展示拟议的修改，并征求你的批准。这是正常且安全的过程——由你决定机器上发生什么。

第 5 步：批准或拒绝修改

当 Claude Code 想要编辑文件或运行命令时，它会先征求你的许可。输入 y 并按回车批准，或输入 n 拒绝。请检查每一项修改——主动权始终在你手里。

你还可以按 Shift + Tab 循环切换权限模式：

  • 默认模式 —— Claude 每次修改前都会询问
  • acceptEdits 模式 —— 文件编辑自动批准（运行命令仍会询问）
  • plan 模式 —— Claude 只提出计划，不做任何修改

第 6 步：退出 Claude Code

完成后，输入 /exit 并按回车，或按两次 Ctrl + D。

常用命令

命令作用
claude启动交互式会话
claude "任务描述"带着一次性任务启动会话
claude -p "问题"运行一次性查询后退出（适合脚本）
claude -c继续此文件夹中最近的一次对话
claude -r恢复之前的对话
claude update更新到最新版本
claude doctor检查安装是否健康
/help显示所有可用命令（会话内）
/clear清除对话历史（会话内）
/login切换账号或重新登录（会话内）
/usage显示会话的使用量和费用（会话内）
/exit 或按两次 Ctrl + D退出 Claude Code

常见问题

需要付费订阅吗？

需要。Claude Code 要求付费的 Claude 订阅（Pro 每月 $20 起按月计费、Max 每月 $100 起、Team 或 Enterprise）或按量付费的 Claude Console 账号。免费的 Claude.ai 套餐不包含 Claude Code。请查看官方定价页了解当前选项。

Claude Code 可以在 git 仓库之外工作吗？

Claude Code 在 Git 项目中表现最好。如果你从零开始，请先创建仓库：

bash
git init

Claude Code 能运行我的代码吗？

可以，但需要你的许可。Claude Code 可以在你的机器上运行 shell 命令和测试，并且每次执行前都会显示要运行的内容。你可以用权限模式（Shift + Tab）控制它可以不经询问做哪些事。

我的代码会发送给 Anthropic 吗？

使用 Claude Code 时，你的提示词和文件内容会按照你账号类型对应的数据控制政策进行处理。详情请查阅 Anthropic 的数据使用文档。

什么是 MCP？

MCP（Model Context Protocol，模型上下文协议）是一种将 Claude Code 连接到外部工具和数据源（如数据库或内部服务）的标准方式。之后你可以在会话内用 /mcp 添加 MCP 服务器——这是进阶功能，起步阶段不需要。

下一步

  • 添加项目指引： 在仓库中创建 CLAUDE.md 文件，为 Claude Code 提供关于项目的长期指令。
  • 学会提问： 描述需求时尽量具体——说明目标和约束，而不是只说"修一下这个 bug"。
  • 掌握权限模式： 随着你越来越有信心，用 Shift + Tab 在询问许可和更自主的模式之间切换。
  • 在其他地方使用 Claude Code： Claude Code 还提供桌面应用、VS Code 和 JetBrains IDE 插件以及网页版。
  • 用 MCP 连接工具： 使用 /mcp 让 Claude Code 访问外部数据和服务。
#Claude Code#AI Coding#Terminal#Anthropic
返回教程

相关教程