教程

零基础终端入门: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 官方文档

相关文章推荐

教程OpenClaw TUI 完全指南:纯键盘操作的终端管理界面使用详解OpenClaw TUI(Terminal User Interface,终端用户界面)完整使用指南:TUI 与 Control UI(浏览器)的定位对比、适合 TUI 的场景(SSH 远程/无浏览器服务器/低带宽环境)、启动命令(openclaw tui)及参数、界面布局(Agents 面板/Sessions 面板/Channels 状态/Logs 实时流)、全键盘快捷键手册(导航/选择/搜索/刷新/退出)、在 TUI 中发送测试消息、实时日志过滤与搜索,以及 TUI 与 tmux/screen 配合使用的后台运行方案。2026/3/25教程Claude Code MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18教程Claude Code 权限管理完全指南:精确控制 AI 能执行哪些操作Claude Code 权限系统完整解析:四种权限模式(default/acceptEdits/bypassPermissions/plan)、--allowedTools 和 --disallowedTools 精确工具控制、Bash 命令白名单语法(通配符匹配)、settings.json 持久化权限配置、CLAUDE.md 中的权限规则声明、CI/CD 自动化场景的权限配置、以及如何在效率和安全之间找到平衡点。2026/3/18教程Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18