如何安装并使用 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。

4 GB
官方最低内存
0
免费套餐访问
1
浏览器登录

第一次:安装、登录、改一行能审查的代码

  1. 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-codewinget install Anthropic.ClaudeCode。原生安装会后台自动更新;Homebrew 与 WinGet 默认要手动升级。

  2. 2

    核对版本再开会话

    新开终端,跑 claude --version,应看到类似 2.1.211 (Claude Code)。失败就跑 claude doctor。原生安装把启动器放在 ~/.local/bin/claude(macOS/Linux)。command not found 时先检查 PATH,再查官方 Troubleshoot installation。

  3. 3

    在项目目录登录

    cd 到你拥有的仓库,执行 claude。首次会打开浏览器。设了 ANTHROPIC_API_KEY 则只问一次是否用该密钥。浏览器没弹出来时,按提示复制登录 URL。成功后终端写 Login successful。会话里 /login 可换号,/logout 可退出。

  4. 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
01

装完找不到命令

多半是 PATH。关掉旧窗口,新开终端。仍失败就跑 claude doctor,或对照官方 Troubleshoot installation and login。

02

PowerShell 和 CMD 装反了

&& 报错说明你在 PowerShell;irm 找不到说明你在 CMD。提示符带 PS 才用 irm

03

第一任务停在闲聊

「这个仓库做什么」只是热身。要有一条可审查的改动:单测、校验或修一个你点名的小 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。不要在提示里贴密钥。

免费开始开会