古法编程

首次使用终端的用户可按本指南顺序操作，完成 Claude Code 安装并发起第一次对话。macOS 用户需系统版本 13.0 以上，Windows 用户需 Windows 10 版本 1809 以上。安装后键入 claude 启动，按提示登录即可。如遇 command not found，需重新打开终端或手动添加 $HOME/.local/bin 到 PATH。Windows 默认使用 PowerShell，若安装失败，请确认当前 shell 类型。

Claude Code 终端安装必读：macOS 与 Windows 新手上手指南

如果你从未使用过终端，本文会一步步教你如何打开终端、安装 Claude Code 并完成首次交互。

本文分为两部分：

不想用终端？Claude Code 桌面版可完全跳过终端。macOS 用户点此下载，Windows 用户点此下载，然后参考桌面版快速开始。

macOS 和 Linux 安装步骤

以下步骤适用于 macOS 13.0 及以上版本。Linux 支持的发行版见系统要求。

1. 打开终端

macOS：按 Cmd + Space 打开 Spotlight，输入 Terminal，回车。

Linux：打开你的终端应用（多数发行版可按 Ctrl + Alt + T，或在应用菜单中搜索"Terminal"）。

你会看到一个带有闪烁光标的窗口，这就是终端。

2. 安装 Claude Code

复制下面这行命令，粘贴到终端（macOS 按 Cmd + V，Linux 按 Ctrl + Shift + V），然后回车：

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

这条命令会从 claude.ai 下载并运行安装脚本。你会看到滚动的文字输出。安装完成后，会显示 “Claude Code successfully installed!”。如果出现错误，请查看下方的故障排查部分。

3. 启动 Claude Code

输入以下命令并回车：

claude

系统会提示你登录 Claude 账户。按照屏幕指引操作，浏览器窗口会自动打开供你登录。

4. 开始使用

登录后，你就可以向 Claude 提问了。Claude Code 完全在文本模式下运行，你输入消息后按回车发送。需要注意：

  • 终端里不能点击；用方向键移动光标。
  • 按 Esc 可中断 Claude 正在执行的操作。
  • 输入 exit 或按 Ctrl + D 退出 Claude Code。
  • 输入 /help 查看所有可用命令。

Windows 安装步骤

以下步骤适用于 Windows 10 版本 1809 及以上。如需完整系统要求，参见系统要求。

1. （可选）安装 Git for Windows

Git for Windows 提供了 Git Bash，让 Claude Code 能使用 Bash 环境。如果没有安装，Claude Code 会改用 PowerShell。

如果你还没有安装：

  1. 访问 git-scm.com/downloads/win 下载安装程序。
  2. 运行安装程序。一路上点击 Next 接受默认值即可。安装界面很多，但你不需要改动任何设置。
  3. 如果提示选择编辑器，保留默认选项，点击 Next。
  4. 看到 “Adjusting your PATH environment” 时，保持推荐选项选中。

已经装了 Git？可以跳过这一步。如果不确定，再装一次也没问题。

2. 打开 PowerShell

PowerShell 是 Windows 自带的终端程序。

按 Win + X，从菜单中选择 Windows PowerShell（或 Terminal）。你会看到一个带闪烁光标的窗口，这就是你的命令输入界面。

Windows 有两个命令行程序：PowerShell 和 CMD。它们看起来很相似，但命令不同。请确保你使用的是 PowerShell。

如何区分：

  • PowerShell：每行开头显示 PS C:\Users\你的用户名>
  • CMD：显示 C:\Users\你的用户名>（没有 PS）

3. 安装 Claude Code

复制下面这行命令，粘贴到 PowerShell（Ctrl + V 或右键粘贴），然后回车：

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

这条命令会下载并运行安装脚本。irm 负责下载文件，iex 负责执行它。你会看到文字滚动。安装完成后，会显示 “Claude Code successfully installed!”。如果出现错误，请查看下方的Windows 故障排查部分。

如果你在 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 提问了。Claude Code 完全在文本模式下运行，输入消息后按回车发送。几点注意：

  • 终端里不能点击；用方向键移动光标。
  • 按 Esc 可中断 Claude。
  • 输入 exit 或按 Ctrl + D 退出。
  • 输入 /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 不限于终端，还提供以下途径：

更多学习资源

故障排查

macOS 和 Linux 故障排查

‘command not found: claude’ 怎么解决？

安装后如果看到 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。

安装时出现 HTML 代码或 ‘syntax error near unexpected token’ 怎么解决？

如果你看到 bash: line 1: syntax error near unexpected token '<' 或类似 <!DOCTYPE html> 的 HTML 代码，说明下载地址返回的是网页而非安装脚本。

如果网页显示 “App unavailable in region”，说明你所在的国家/地区暂不支持 Claude Code。查看支持的国家列表。

否则，重新运行命令。如果问题持续，改用 Homebrew 安装：

brew install --cask claude-code

‘dyld’ 错误或 ‘built for Mac OS X 13.0’ 怎么解决？

如果看到 dyld: cannot load、dyld: Symbol not found 或 built for Mac OS X 13.0，说明 macOS 版本可能低于 Claude Code 的要求。

打开苹果菜单，选择"关于本机"查看版本号。如果低于 13.0，通过软件更新升级系统。详情见macOS 故障排查指南。

其他错误请参考完整的安装故障排查指南。

Windows 故障排查

‘irm is not recognized’ 怎么解决？

你目前在 CMD 而非 PowerShell。关闭此窗口，改为打开 PowerShell（Win + X 后选择 Windows PowerShell）。

或者使用 CMD 安装命令：

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

SSL/TLS 错误或 ‘Could not create SSL/TLS secure channel’ 怎么解决？

这通常发生在较旧的 Windows 10 系统上。先运行以下命令，再重新安装：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

‘Claude Code on Windows requires either Git for Windows (for bash) or PowerShell’ 怎么解决？

系统未检测到 PowerShell 或 Git Bash。Claude Code 至少需要一个可用的 shell。

  1. 确认 powershell.exe 在 PATH 中。它的默认位置是 C:\Windows\System32\WindowsPowerShell\v1.0\。或者安装 PowerShell 7（提供 pwsh 命令）。
  2. 如果更想用 Git Bash，请按上文 Windows 部分第一步安装 Git for Windows。
  3. 如果 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 is not recognized’ 怎么解决？

重启电脑再试，通常能解决。

如果仍无效，运行以下命令将 Claude Code 添加到 PATH：

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

关闭 PowerShell，打开新窗口，再试一次 claude。更多信息见验证 PATH。

其他错误请参考完整的安装故障排查指南。

常见问题

Mac 安装后提示 ‘command not found: claude’，重启终端也没用怎么办？

需要手动添加 $HOME/.local/bin 到 PATH。运行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc 然后执行 source ~/.zshrc，再试 claude。

Windows 上 PowerShell 安装时提示 ‘irm is not recognized’ 怎么解决？

你当前在 CMD 而非 PowerShell。按 Win + X 选择 Windows PowerShell，或者直接在 CMD 中使用 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 命令安装。

安装完成后，我应该输入什么命令来启动 Claude Code？

在终端或 PowerShell 中输入 claude 并回车，然后按照提示登录你的 Claude 账户即可开始使用。