终端里的 Claude Code 就是一条安装命令、一句 claude，然后说人话。真正卡住人的不是那个 agent，而是它前后十分钟——shell 说命令不存在，而你搜到的教程里列着官方页面从来没有过的参数。
所以本文不越出官方文档：下面每一条命令都抄自 Claude Code 的终端指南、快速上手、总览或 CLI 参考，官方没写的就不写。
Claude Code 是什么，用厂商自己的话
总览开头那句值得逐字读：「Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools. Available in your terminal, IDE, desktop app, and browser.」
终端只是其中一个界面，而且它们共用同一套引擎：「Each surface connects to the same underlying Claude Code engine, so your repo’s CLAUDE.md files, settings, and MCP servers work across all of them.」如果你已经在用 IDE 扩展或桌面端，转终端并不是从零开始。
总览里还有一句定位常被跳过：Claude Code 是可组合的，遵循 Unix 哲学。落到操作上就是它能被接进你已经有的命令行流程，而不是要求你把流程搬进它。
安装前，先确认机器满足什么
官方公布了三个约束，先对一遍能省下一次失败的安装。macOS 要求 13.0 或更高版本。Windows 要求 10 的 1809 或更高版本，并且不支持 32 位 Windows。Linux 要看发行版，终端指南给的是链接而不是清单。
Windows 上 Git for Windows 是可选项，但装了有用：它提供 Git Bash，而 Bash 工具走的就是它。不装的话，Claude Code 通过 PowerShell 运行。
账号方面有一条：需要一个 Claude 订阅（Pro、Max、Team 或 Enterprise）、一个 Claude Console 账号，或者通过受支持的云厂商接入。如果环境里已经导出了 ANTHROPIC_API_KEY，文档写的是 Claude Code 会跳过登录提示，改成让你确认这把 key。
安装：每个平台一行
# macOS、Linux 与 WSL
curl -fsSL https://claude.ai/install.sh | bash
# 确认装上了
claude --versionWindows 对应两条：PowerShell 用 irm https://claude.ai/install.ps1 | iex，CMD 用 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。PowerShell 和 CMD 是两个程序，命令不通用，指南给了辨别方法：PowerShell 每行开头是 PS C:\Users\YourName>，CMD 没有 PS。
也可以走包管理器
文档里写了两个。Homebrew 装 macOS 版：brew install --cask claude-code；WinGet 装 Windows 版：winget install Anthropic.ClaudeCode。Linux 侧在 Debian、Fedora、RHEL、Alpine 上也有对应包管理器，命令放在 Linux 安装页而不是终端指南里。
claude --version 会打印类似 2.1.211 (Claude Code) 的版本串，这是文档给出的唯一一个信号，说明你 PATH 上的那个二进制就是安装程序刚写下的那个。
开一个会话，屏幕在等什么
cd /path/to/your/project
claude在你要改的那个仓库里执行。没有上传这一步：Claude Code 按需读取你的项目文件。启动后，提示符上方会显示版本、当前模型和工作目录。
登录只做一次，终端会打开一个浏览器窗口。会话已经跑起来时，/login 做同一件事。进去以后，快速上手里公布的会话命令有三条：/help 看有哪些可用命令，/clear 清掉对话历史，/exit 退出，在空提示符上按两次 Ctrl+D 也可以。/resume 用来回到之前的对话。
终端指南另外给了三条自然语言提示，可以拿来快速自测：make me a simple webpage that says hello world、look at the screenshots on my Desktop and rename them based on what's in each image、I want to build a personal budget tracker. What would I need?。三条分别试的是从零建文件、整理你已有的文件，以及先规划再动手。
代替鼠标的那几个键
终端指南里最实用的一段，讲的就是终端里点不了。方向键移动，Enter 发送消息、也用来批准权限请求，Esc 在 Claude 干活时打断它。这四个习惯够撑过第一个小时。
Shift+Tab 最值得记住。它切换当前会话的权限模式，而文档注明起始模式取决于你的方案。
不开会话，只跑一条任务
会话并不总是你要的。CLI 参考里还写了几种更短的用法：给一个答案，然后把你还给 shell。
# 带一条开场提示进入交互模式
claude "fix the build error"
# 回答一个问题就退出
claude -p "explain this function"
# 接着这个目录里最近的那次对话
claude -c
# 按 ID 或名字恢复指定会话
claude -r "auth-refactor" "Finish this PR"claude "query" 和 claude -p "query" 的区别写在参考里，也最容易被漏掉：前者进入交互模式，只是提示词已经填好；-p 回答完就退出，脚本里要的是这个。-c 和 -r 都是恢复旧工作，-c 取当前目录里最近的一次，-r 取你点名的那次。
-p 还有一条管道用法，参考里写作 cat logs.txt | claude -p "explain"：前一 process 的输出直接当输入，适合把 Claude 塞进已有的日志排查脚本。
谁来批准一次文件改动
没有你的决定，什么都不会被写下去，而公布的起始模式取决于方案。快速上手写明：在 Pro、Max 和 Team 方案上，交互式终端会话的默认起始模式是 auto mode，由分类器代替你审阅动作，Claude 编辑大多数文件、运行大多数命令都不再询问。其他方案上，会话从 Manual 模式开始。
两种情况都可以用 Shift+Tab 在会话中途换模式；起始模式由你的设置或所在组织决定，所以下一次启动未必还是今天这个。真的弹出询问时，按 Enter 选 Yes。终端指南把这件事说得很直白：创建或修改文件之前，Claude 会请求你的许可。
这些用量是不是单独计费，Anthropic 的定价 FAQ 有答案：Claude Code 包含在所有付费方案里，和方案其余部分共用同一份用量限制，从同一个池子里扣。价格方案拆解逐个档位讲了这件事。
命令找不到的时候
command not found: 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安装程序返回了一个网页
另一种症状是另一种原因。拿到的是 HTML 而不是脚本，或者报 syntax error near unexpected token，说明那个安装 URL 回的是一个页面而不是安装程序。指南点名了要找的那句：「App unavailable in region」表示所在国家或地区不支持。
指南还给了一个自查点：确认 ~/.local/bin/claude 这个文件确实存在。文件不在，说明安装本身没跑完，改 PATH 是没用的。
另外三条消息也有官方解释。macOS 上出现带 built for Mac OS X 13.0 的 dyld 报错，说明系统低于支持的版本。Windows 上 irm is not recognized 说明你在 CMD 里而不是 PowerShell 里，而 'claude' is not recognized 是 PATH 问题的 Windows 版本，修法是把 %USERPROFILE%\.local\bin 加进去。提到 32 位 Windows 的提示，说明你开的是带 (x86) 的那个 PowerShell 入口，关掉换成不带 (x86) 的再试。
常见问题
需要会写代码吗？ 终端指南说不用，建议用大白话描述你想要什么，上面那三条提示就是它给的例子。
一定要用终端吗？ 不必。总览列了终端、VS Code 与 JetBrains 扩展、桌面端，以及 claude.ai/code 网页版。终端是命令最全的那个界面。
怎么升级？ Homebrew 用户跑 brew upgrade claude-code，WinGet 用户跑 winget upgrade Anthropic.ClaudeCode。CLI 参考里还写了 claude update，升到最新版本。
跑起来之后从哪开始？ Claude 上手指南讲产品那一侧；如果你更想直接调 API 而不是驱动一个 agent，Claude API 接入指南给了请求长相。另一种第一步是先把要花的钱比清楚，在 Claude 与 DeepSeek 对比里。
装好、确认版本、在仓库里启动、按一次 Shift+Tab 看看自己在哪个模式。剩下的都是说话。