教程

零基础终端入门: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 Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8教程Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。2026/5/8教程Claude Code Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8