教程

零基础终端入门:macOS/Linux/Windows 三平台安装 Claude Code 的逐步指南

零基础终端入门指南:macOS 四步(Command+空格打开终端/安装脚本/重启/claude 启动)、Linux 四步(Ctrl+Alt+T/安装/source/.bashrc/启动)、Windows 五步(安装 Git for Windows/打开 PowerShell/irm 安装脚本/重启/启动)、SSL/TLS 错误修复、安装后三个入门示例(网页/文件整理/规划咨询)、五大常见安装问题(command not found/HTML 错误/irm not recognized/Git Bash 缺失/claude not recognized),以及无需终端的替代方案(桌面应用/VS Code 插件/网页版)。

2026/3/84分钟 阅读ClaudeEagle

从未用过终端?没关系。本文手把手带你打开终端、安装 Claude Code,完成第一次对话——全程不需要任何编程知识。

macOS 安装步骤

第一步:打开终端

方法一:按 Command + 空格,搜索「Terminal」,回车打开

方法二:打开「应用程序」→「实用工具」→「终端」

第二步:安装 Claude Code

在终端窗口中,复制粘贴以下命令,按回车执行:

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

等待安装完成(约 1-2 分钟)。

第三步:关闭并重新打开终端

安装后需要重启终端让配置生效。关闭终端窗口,重新打开一个新的终端。

第四步:启动 Claude Code

bash
claude

首次启动会打开浏览器要求登录,用你的 claude.ai 账号登录即可。


Linux 安装步骤(Ubuntu/Debian)

第一步:打开终端

  • Ubuntu:按 Ctrl + Alt + T
  • 其他发行版:在应用程序菜单中搜索「Terminal」或「终端」

第二步:安装 Claude Code

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

第三步:重载 Shell 配置

bash
source ~/.bashrc
# 或关闭终端重新打开

第四步:启动

bash
claude

Windows 安装步骤

第一步:安装 Git for Windows

前往 git-scm.com/downloads/win 下载安装 Git for Windows。

安装时保持默认选项,一路「Next」即可。

第二步:打开 PowerShell

按 Win + X,点击「Windows PowerShell」(或「终端」)。

不要用「命令提示符(CMD)」,需要用 PowerShell。

第三步:安装 Claude Code

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

如果出现 SSL/TLS 错误,先运行这行再重试:

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

第四步:重启 PowerShell

关闭 PowerShell 窗口,重新打开。

第五步:启动 Claude Code

powershell
claude

安装成功后能做什么?

看到 Claude Code 欢迎界面后,你不需要会写代码。用中文描述你想做的事就行。

创建一个简单网页

帮我创建一个显示「Hello World」的简单网页

Claude 会帮你创建文件,双击生成的 HTML 文件即可在浏览器中查看。

整理文件

看一下我桌面上的截图,根据图片内容重命名它们

学习和规划

我想做一个个人预算记录工具,需要哪些步骤?

常见安装问题

macOS/Linux:command not found

关闭终端重新打开,再次运行 claude。

如果还是不行:

bash
# Zsh(macOS 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash(Linux 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

macOS/Linux:出现 HTML 代码或 syntax error

安装脚本下载到了 HTML 页面。改用 Homebrew:

bash
brew install --cask claude-code

Windows:irm is not recognized

你在 CMD 里,需要用 PowerShell。关闭 CMD,改用 Win + X 打开 PowerShell。

Windows:Claude Code on Windows requires git-bash

Git for Windows 未安装,回到第一步重新安装。如果已安装但仍报错:

powershell
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

然后再运行 claude。

Windows:claude is not recognized

重启电脑后再试。如果仍不行:

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

关闭 PowerShell,重新打开后再试。


其他使用 Claude Code 的方式

如果不想用终端,Claude Code 还提供:

  • 桌面应用:图形界面,无需终端
  • VS Code / JetBrains 插件:在编辑器中直接使用
  • 网页版:在 claude.ai/code 使用,无需安装
  • GitHub Actions / GitLab CI/CD:自动化流水线集成

原文:Terminal guide - Claude Code Docs | 来源:Anthropic 官方文档

相关文章推荐

教程Claude Code 新手入门完整教程:安装、登录、第一个任务全流程(2026 最新)Claude Code 新手入门完整教程:从安装到第一个任务全流程,涵盖 macOS/Windows/Linux 安装、常见报错处理、核心命令速查和 5 个高频使用场景。2026/4/9教程Claude Code Week 34:/design 技能上线,可编辑 UI 画板、Concise 输出风格、手机一键启动会话Claude Code 2026年8月17-21日(Week 34)更新详解:全新/design技能带来可编辑UI画板工作流(研究预览)、Concise内置输出风格直给结果跳过过程叙述、Remote Control正式版支持手机一键启动本机会话,附完整使用方法与实战建议。2026/8/23教程Claude Code v2.1.239:修复 Bedrock 代理下静默双倍计费漏洞,/claude-api upgrade 一键迁移 SDK详解Claude Code v2.1.239更新:修复Bedrock流式传输代理剥离Content-Type头导致静默双倍计费的重要问题、数据驻留工作区成本估算加入1.1倍溢价、新增/claude-api upgrade一键迁移Python SDK到1.x、云端插件同步区分来源、Alpine musl原生插件加载修复。2026/8/22教程Claude Code v2.1.238:Remote Control 连接韧性大幅提升,新增 readline 风格快捷键详解Claude Code v2.1.238更新:新增keybindingFlavor readline快捷键风格、插件市场headersHelper动态认证头、自托管Runner缓冲关闭与代理认证增强、Remote Control网络断连/登录过期/进程崩溃后自动恢复等一揽子稳定性修复、长会话内存无限增长问题修复。2026/8/21教程CLAUDE.md、Rules、Skills、Subagents、Hooks 到底该用哪个?Anthropic 官方给出决策指南Anthropic官方决策指南详解Claude Code五种指令控制机制:Path-scoped Rules按路径精准加载省Token、Skills程序性操作手册动态加载、Subagents隔离上下文支持五层嵌套、Hooks确定性拦截控制、Output styles高权重系统提示注入,附完整决策速查表。2026/8/20教程Claude Code v2.1.236/237:新增 Concise 简洁输出风格,沙箱通配符拒绝规则加固详解Claude Code v2.1.236/v2.1.237更新:新增内置Concise简洁输出风格跳过过程叙述、ANTHROPIC_DEFAULT_MODEL环境变量、跨会话notify_when_idle空闲通知、macOS沙箱通配符拒绝规则安全加固、LLM网关prompt缓存失效修复等实用改进。2026/8/20