Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

即使您从未使用过终端，也可以使用 Claude Code。本指南将引导您打开终端、安装 Claude Code 以及进行首次交互。
不想使用终端？Claude Code 桌面应用程序让您可以完全跳过终端。为 macOS 或 Windows 下载，然后查看 桌面快速入门 以开始使用。

​
macOS 和 Linux

按照以下步骤从 macOS 或 Linux 终端安装并启动 Claude Code。Claude Code 需要 macOS 13.0 或更高版本。有关支持的 Linux 发行版，请参阅 系统要求。
1

打开终端

macOS：按 Cmd + Space 打开 Spotlight 搜索，输入 Terminal，然后按 Enter。Linux：打开您的终端应用程序。在大多数发行版上，按 Ctrl + Alt + T 或在应用程序菜单中搜索”Terminal”。将出现一个带有闪烁光标的窗口。这是您的终端，您可以在其中输入命令。
2

安装 Claude Code

复制此行，将其粘贴到您的终端中（macOS 上按 Cmd + V，Linux 上按 Ctrl + Shift + V），然后按 Enter：
curl -fsSL https://claude.ai/install.sh | bash
这将从 claude.ai 下载并运行 Claude Code 安装程序。您将看到文本滚动。完成后，您将看到”Claude Code successfully installed!”。如果您看到错误，请检查下面的 故障排除部分。
3

启动 Claude Code

输入 claude 并按 Enter：
claude
系统将提示您使用 Claude 账户 登录。按照屏幕上的说明操作。浏览器窗口将打开供您登录。
4

开始使用 Claude Code

登录后，您可以开始向 Claude 提问有关您的代码或其他任何内容的问题。Claude Code 完全以文本形式运行。您输入消息并按 Enter 发送。需要了解的几点：
  • 您无法在终端中点击任何内容。使用箭头键移动。
  • 按 Esc 中断 Claude（如果它正在运行）。
  • 输入 exit 或按 Ctrl + D 退出 Claude Code。
  • 输入 /help 查看可用命令。

​
Windows

按照以下步骤在 Windows 上安装 Git、设置 PowerShell 并启动 Claude Code。Claude Code 需要 Windows 10 版本 1809 或更高版本。有关完整详情，请参阅 系统要求。
1

为 Windows 安装 Git

Git 是 Claude Code 内部用来跟踪代码更改的工具。您不需要自己学习 Git。如果您还没有安装：
  1. 转到 git-scm.com/downloads/win 并下载安装程序
  2. 运行安装程序。在每个屏幕上单击”下一步”以接受默认设置。安装程序有很多屏幕，但您不需要更改任何内容。
  3. 如果它要求您选择编辑器，请保持默认值并单击”下一步”。
  4. 当您看到”调整您的 PATH 环境”时，保持推荐选项的选中状态。
已经有 Git？您可以跳过此步骤。如果您不确定，无论如何都可以安装。重新安装不会导致问题。
2

打开 PowerShell

PowerShell 是 Windows 用于输入命令的内置终端。它预装在每台 Windows 计算机上。按 Win + X 并从菜单中选择 Windows PowerShell（或 Terminal）。将出现一个带有闪烁光标的窗口。这是您输入命令的地方。
Windows 有两个命令行程序：PowerShell 和 CMD。它们看起来相似，但使用不同的命令。确保您在 PowerShell 中进行下一步。判断您在哪个程序中的方法：
  • PowerShell：在每行的开头显示 PS C:\Users\YourName>
  • CMD：显示 C:\Users\YourName>，没有 PS
3

安装 Claude Code

复制此行，使用 Ctrl + V 或右键单击将其粘贴到 PowerShell 中，然后按 Enter：
irm https://claude.ai/install.ps1 | iex
这将下载并运行 Claude Code 安装程序。irm 获取文件，iex 运行它。您将看到文本滚动。完成后，您将看到”Claude Code successfully installed!”。如果您看到错误，请检查下面的 故障排除部分。
如果您在 CMD 中而不是 PowerShell 中，请使用此命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4

启动 Claude Code

关闭 PowerShell 并打开一个新的 PowerShell 窗口，以便它识别新安装的 claude 命令。然后输入：
claude
系统将提示您使用 Claude 账户 登录。按照屏幕上的说明操作。浏览器窗口将打开供您登录。
5

开始使用 Claude Code

登录后，您可以开始向 Claude 提问有关您的代码或其他任何内容的问题。Claude Code 完全以文本形式运行。您输入消息并按 Enter 发送。需要了解的几点：
  • 您无法在终端中点击任何内容。使用箭头键移动。
  • 按 Esc 中断 Claude（如果它正在运行）。
  • 输入 exit 或按 Ctrl + D 退出 Claude Code。
  • 输入 /help 查看可用命令。

​
接下来呢？

一旦您看到 Claude Code 欢迎屏幕，您就可以开始了。您不需要知道如何编码。用简单的英文描述您想要的内容，Claude 将为您编写代码。

​
构建项目

Claude 可以根据描述创建项目： 
make me a simple webpage that says hello world
Claude 为您创建文件。双击 HTML 文件在浏览器中打开它。

​
处理计算机上的文件

Claude 可以读取和组织您已有的文件： 
look at the screenshots on my Desktop and rename them based on what's in each image

​
提出问题

Claude 可以解释事物、帮助您学习或规划项目： 
I want to build a personal budget tracker. What would I need?
如果您还没有项目，没关系。Claude 可以帮助您启动一个新项目。

​
使用 Claude Code 的其他方式

您不必使用终端。Claude Code 也可在以下位置使用：

​
了解更多

​
故障排除

​
macOS 和 Linux 故障排除

如果您在 macOS 或 Linux 上安装时遇到问题，请检查这些常见问题：
如果在安装后看到 command not found: claude，您的终端需要重新加载其设置。关闭终端窗口并打开一个新窗口，然后再次尝试 claude。如果仍然不起作用，请将安装目录添加到您的 PATH。为您的 shell 运行命令：
# Zsh (macOS 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
然后再次尝试 claude。有关更多详情，请参阅 修复您的 PATH。
如果您看到 bash: line 1: syntax error near unexpected token '<' 或终端中出现 HTML 代码（如 <!DOCTYPE html>），安装 URL 返回了网页而不是安装程序脚本。如果页面显示”App unavailable in region”，Claude Code 在您的国家/地区不可用。请参阅 支持的国家/地区。否则，请尝试再次运行该命令。如果继续发生，请改用 Homebrew 安装：
brew install --cask claude-code
如果您看到 dyld: cannot load、dyld: Symbol not found 或 built for Mac OS X 13.0，您的 macOS 版本可能比 Claude Code 支持的版本更旧。打开 Apple 菜单并选择”关于本机”以检查您的版本。如果它比 13.0 更旧，请通过软件更新更新 macOS。有关更多详情，请参阅 macOS 故障排除指南。
有关其他错误，请参阅完整的 安装故障排除指南。

​
Windows 故障排除

如果您在 Windows 上安装时遇到问题，请检查这些常见问题：
您在 CMD 中，而不是 PowerShell。关闭此窗口并改为打开 PowerShell（Win + X 然后选择 Windows PowerShell）。或者，使用 CMD 安装命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
这通常发生在较旧的 Windows 10 系统上。首先运行此行，然后重试安装：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
未找到 Git for Windows 或 PowerShell。Claude Code 需要至少一个 shell。如果仅找到 PowerShell，Claude Code 将使用 PowerShell 工具而不是 Bash。
  1. 如果您还没有安装 Git，请返回 Windows 部分的第一步。或者，安装 PowerShell 7。
  2. 如果 Git 已安装但 Claude Code 找不到它，请告诉它在哪里查找： 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    然后再次运行 claude。如果您的 Git 安装在其他地方，请通过运行以下命令找到路径： 
    Get-Command git | Select-Object Source
    在该路径中查找 Git\bin 文件夹并改用它。
要使其永久化，以便您不必每次都设置它，请参阅 配置 Git Bash 路径。
重新启动计算机并重试。这通常可以解决问题。如果重新启动没有帮助，请运行这些命令将 Claude Code 添加到您的 PATH：
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
关闭 PowerShell，打开一个新窗口，然后再次尝试 claude。有关更多详情，请参阅 验证您的 PATH。
有关其他错误，请参阅完整的 安装故障排除指南。