如何安装并使用 Claude Code:首次安装、登录与第一个编程任务
从官方安装命令到浏览器登录,再到仓库里的第一个可审查改动。免费套餐不能用。
第一次用 Claude Code 时,卡住的通常不是「会不会写提示」,而是安装命令、账号档和第一个能审查的改动对不上。按官方文档装完、登录,再在你自己的仓库里做一件小事。
检索词是 如何安装并使用 Claude Code。下文按 Anthropic 的安装页、认证页和 code.claude.com/docs/en/quickstart 来写。免费 Claude.ai 不含 Claude Code。装好代理后要约短会对齐改动,用 wbmeet 建房即可,步骤见 如何创建与加入房间。
先核对能不能用
官方安装页写:macOS 13.0+,Windows 10 1809+ 或 Windows Server 2019+,Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+,4 GB 内存,x64 或 ARM64,需要联网,且须在 Anthropic 支持的地区。也提供桌面端,本页只走终端 CLI。
第一次:安装、登录、改一行能审查的代码
- 1
用官方原生安装
macOS、Linux、WSL:
curl -fsSL https://claude.ai/install.sh | bash。Windows PowerShell:irm https://claude.ai/install.ps1 | iex。提示符带PS才是 PowerShell;不带则是 CMD,应改用install.cmd。也可brew install --cask claude-code或winget install Anthropic.ClaudeCode。原生安装会后台自动更新;Homebrew 与 WinGet 默认要手动升级。 - 2
核对版本再开会话
新开终端,跑
claude --version,应看到类似2.1.211 (Claude Code)。失败就跑claude doctor。原生安装把启动器放在~/.local/bin/claude(macOS/Linux)。command not found时先检查 PATH,再查官方 Troubleshoot installation。 - 3
在项目目录登录
cd到你拥有的仓库,执行claude。首次会打开浏览器。设了ANTHROPIC_API_KEY则只问一次是否用该密钥。浏览器没弹出来时,按提示复制登录 URL。成功后终端写 Login successful。会话里/login可换号,/logout可退出。 - 4
做一个能审查的第一任务
先问:「这个项目做什么?入口在哪?」再下一条:「给一个没测试的辅助函数补单测,或给一个对外函数加输入校验。先出示 diff,等我同意再改。」官方 quickstart 也是先理解仓库,再做小改动。用 Shift+Tab 切换权限模式;不要把密钥写进提示。
# Official native install · as of 2026-09
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
claude --version
cd /path/to/your/project
claude
# first task (inside the session)
# 1) what does this project do and where is the entry point?
# 2) add a unit test for one untested helper; show the diff first账号、安装通道、常见坑
| 路径 | 官方怎么写 | 第一次注意 |
|---|---|---|
| 免费 Claude.ai | 不含 Claude Code | 先升级或改用 Console |
| Pro / Max / Team / Enterprise | 浏览器登录 | 官方推荐订阅档 |
| Console API | 预付积分;会建 Claude Code workspace | 看用量,别当无限 |
| 原生 install.sh / .ps1 | 推荐;后台自动更新 | 新开终端再跑 claude |
| Homebrew / WinGet | 不自动升级 | brew upgrade / winget upgrade |
装完找不到命令
多半是 PATH。关掉旧窗口,新开终端。仍失败就跑 claude doctor,或对照官方 Troubleshoot installation and login。
PowerShell 和 CMD 装反了
&& 报错说明你在 PowerShell;irm 找不到说明你在 CMD。提示符带 PS 才用 irm。
第一任务停在闲聊
「这个仓库做什么」只是热身。要有一条可审查的改动:单测、校验或修一个你点名的小 bug,并看 diff。
官方 quickstart:先理解代码库,再让 Claude Code 做一次实际编码。具体命令与账号档以 code.claude.com/docs 为准。
- 原生安装 ≠ Homebrew 自动更新
- 原生安装会后台更新。Homebrew 的
claude-code跟稳定通道,大约晚一周;要手动brew upgrade claude-code。 - Windows 原生 ≠ 必须 WSL
- 可在 PowerShell / CMD 直接装。官方建议装 Git for Windows,以便使用 Bash 工具;不装则走 PowerShell 工具。要 Linux 工具链或沙箱再进 WSL 2。
- 教程页不是会议说明书
- 只讲 Claude Code 第一次。短会白板见 wbmeet,以及何时不必再开沉重会议 App 的 对照笔记。
还想核对的问题
免费 Claude.ai 能用 Claude Code 吗?
官方安装页写:免费套餐不含 Claude Code。需要 Pro、Max、Team、Enterprise 或 Console。企业云另见 Bedrock、Agent Platform、Foundry。
装完提示 command not found 怎么办?
先新开终端再跑 claude --version。仍失败则 claude doctor,并核对本机 PATH 是否包含官方启动器目录(macOS/Linux 常见为 ~/.local/bin)。
Windows 该用哪条安装命令?
提示符是 PS C:\ 用 PowerShell 的 irm … | iex;是 C:\ 且没有 PS,用 install.cmd。不要混用。
第一个任务必须改生产代码吗?
不必。官方允许先问项目做什么。建议紧接着做一件可回滚的小事(单测或校验),并先看 diff。不要在提示里贴密钥。