一句话导读:很多人已经有 claude.ai 聊天账号,终端里输入 claude 却进不了编程会话——卡点通常不是命令记错,而是免费套餐、安装路径和登录方式根本不是同一把钥匙。 下文按 2026 年官方路径写完:注册哪种账号、怎么装、浏览器登录、以及第一次在自己的项目里跑通。
先分清三把钥匙
搜索「Claude Code 怎么注册」时,最容易把三件产品当成一件事:
- claude.ai 网页 / 桌面 / 手机聊天:写稿、问答、看文档。免费账号就能打开聊天。
- Claude Code:在终端(也有桌面应用)里读仓库、改文件、跑命令的编程助手。官方定价页写明:Free 方案不含 Claude Code,Pro、Max 以及 Team / Enterprise 才包含。
- Claude Console 的 API Key:按量扣预充值,和订阅里的用量不是同一本账。环境变量
ANTHROPIC_API_KEY一旦被 Claude Code 采用,就可能绕开你的 Pro 额度。
所以「已经能跟 Claude 聊天」不等于「终端里的 Claude Code 已经开通」。和 Cursor 怎么选 是下一步的问题;这一篇只把注册、登录、第一次运行走通。
注册账号并选套餐
个人用户按这个顺序即可,价格以 claude.com/pricing 当时页面为准(不含税,Anthropic 会调整):
- 用邮箱在 claude.ai 注册。若页面提示你所在地区暂不可用,说明不在 Anthropic 支持的国家/地区内。本文不写绕过办法。
- 打开定价页,把账号升到能包含 Claude Code 的方案。个人最常见是 Pro:月付 20 美元,或年付一次 200 美元(折合每月 17 美元)。
- 整天泡在编程会话里、经常撞上用量墙,再看 Max:5 倍档约 100 美元/月,20 倍档约 200 美元/月。倍数指相对 Pro、每个滚动 5 小时窗口的用量,不是「无限」。
- 公司统一报销:等管理员邀请你加入 Team 或 Enterprise,用那一个 claude.ai 账号登录,不要自己再造一把混用的 Key。
- 财务要求按 token 出账:走 Claude Console(platform.claude.com),预充值。这和订阅额度分开计。
| 方案 | 2026 年 10 月官网标价 | 能否登录 Claude Code |
|---|---|---|
| Free | 0 | 不能。对比表里 Claude Code 为否 |
| Pro | 月付 $20;年付折合 $17/月 | 能。与网页、桌面、手机共用用量 |
| Max 5x / 20x | $100 / $200 每月 | 能。用量约为 Pro 的 5 倍或 20 倍 |
| Team / Enterprise | 按席位,管理员开通 | 用被邀请的账号登录 |
| Console API | 预充值,按量 | 能,但是另一本账单 |
用量是一个池子,不是终端单独无限
官方说明:网页、桌面、手机和 Claude Code 共用额度。付费方案有滚动约 5 小时的会话上限,之上还有周限额。触顶后可以等待重置、升级套餐,或打开 usage credits 按 API 价格继续——那笔钱和 Max 附带的月度 API credits 不是同一项。
安装:macOS、Linux、Windows
官方 Setup 要求大致是:macOS 13+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+;4 GB 以上内存;x64 或 ARM64;安装和推理都要能上网。Shell 用 Bash、Zsh、PowerShell 或 CMD 即可。
优先用原生安装。macOS、Linux、WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell(提示符带 PS):
irm https://claude.ai/install.ps1 | iex
Windows CMD(提示符没有 PS):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
下载过程中安装器可能看起来没有进度,这是正常的。装完新开一个终端窗口再验证:
claude --version
claude doctor
claude --version 应打印版本号(文档示例类似 2.x (Claude Code))。claude doctor 只做只读检查:安装是否健康、配置文件有没有写错,不会开始一次编程会话。
已经在用包管理器时,可以用等价入口,但它们默认不随 Claude Code 自己后台更新:
- Homebrew:
brew install --cask claude-code,以后brew upgrade claude-code - WinGet:
winget install Anthropic.ClaudeCode,以后winget upgrade Anthropic.ClaudeCode - npm(需要 Node.js 22 或更新;包本身会下载原生二进制,运行时不靠你的 Node):
npm install -g @anthropic-ai/claude-code。不要加sudo,否则后面很容易碰到权限错误。
原生安装的启动器一般在 ~/.local/bin/claude。若提示 command not found,先确认是新终端;仍不行再看官方的 Fix your PATH。Windows 上建议安装 Git for Windows,这样 Claude Code 能用 Bash 工具;没装 Git 时会退回 PowerShell。更多安装报错见本站 部署报错修复指南。
不想碰终端的话,官方也提供 macOS / Windows / Linux 桌面应用,能力同属 Claude Code。下面的「第一次运行」仍以 CLI 为准,因为注册教程里大家卡住的就是这一条。
登录:浏览器、验证码、API Key
在项目目录里启动,不要在家目录根上直接开一个无所不包的会话:
cd /path/to/your/project
claude
第一次会尝试打开浏览器。按你的账单类型选:
- Pro 或 Max:用刚才升级过的 claude.ai 账号。
- Team / Enterprise:用管理员邀请的那个账号。
- Console:用 Console 账号登录。较新版本可以走推荐的账号登录,而不必先造一把 API Key;旧的「创建 Key」路径仍在,但那是静态密钥。
- Bedrock、Google Cloud Agent Platform、Microsoft Foundry:按组织要求设置环境变量,或在登录界面选第三方平台,一般不走 claude.ai 浏览器登录。
浏览器没有自动弹出时,在终端按 c 复制登录 URL,粘到本机浏览器。登录后如果页面给你一串代码、终端没有自己跳回来,把它贴到 Paste code here if prompted。这在 WSL2、SSH、容器和远程 Mac 上很常见,因为浏览器访问不到 Claude Code 在本机开的回调端口。成功时终端会显示 Login successful,再按回车进入提示符。凭证会记住,下次不用重复登。
订阅用户先确认没有 API Key 抢登录
若环境里设置了 ANTHROPIC_API_KEY,并且你在提示里同意使用它,Claude Code 会跳过订阅登录,按 Console 价格扣费。想用 Pro / Max 额度时,先去掉这把钥匙,执行 /logout,再重新 claude 并选择订阅账号。
换账号用会话里的 /logout,它会清掉首次引导状态,下次重新走登录。个人和工作号要并存时,官方做法是用不同的 CLAUDE_CONFIG_DIR,例如 CLAUDE_CONFIG_DIR=~/.claude-work claude,两套目录各记各的登录。
第一次运行
登录成功后,提示符上方会看到版本、当前模型和当前目录。第一次不要交给它「把整个产品做完」,用一个你能看懂 diff 的小任务:
- 选一个你有写权限的小仓库。陌生下载目录、公司全盘共享盘,都不要在第一天授权。
- 若询问是否信任当前文件夹,只对你自己的项目选信任。
- 第一条需求写窄,例如:「只改 README,补三行安装说明。不要动其他文件。改完告诉我改了哪几行。」
- 它要执行终端命令时,先读命令再批准。第一次保持「先问再做」,不要关掉确认。
- 看完改动再决定保留还是让它撤回。会话里输入
/help看命令,下次用/resume接上一次对话。
跑通之后,在项目根放一份 CLAUDE.md:技术栈、测试命令、哪些目录不能改、密钥不要进仓库。仓库变大、助手开始漏改调用方时,再看 Graphify 本地知识图谱,那是「看懂整个项目」的下一层,不是注册的前置条件。
常用命令
| 你想做的事 | 命令 |
|---|---|
| 确认装上了 | claude --version |
| 只检查安装和配置 | claude doctor |
| 在当前项目开会话 | claude |
| 重新登录 / 退出 | 会话内 /login、/logout |
| 看命令、接上一次对话 | /help、/resume |
| 原生安装更新 | claude update(Homebrew / WinGet 用各自的 upgrade) |
远程 Mac 与 SSH
在云端 Mac 或 SSH 会话里,浏览器往往回不到那台机器的本机端口。流程是:终端按 c 复制链接,在你自己的电脑上打开并登录,再把页面上的代码贴回远程终端。这是官方写明的回调失败路径,不是额外的「破解登录」。
长会话、Xcode 和本地模型会抢同一台机器的内存。模型订阅按 Anthropic 的套餐走,编译和常驻会话可以放在独享 macOS 上,两边分开记账。机器怎么选可以先看 Claude Code 与 Mac mini 工作站;要 24 小时无人值守,那是另一套部署,见 24 小时编码 Agent 部署,不要和「第一次跑通」混成一步。
卡住时先查这几项
claude找不到:没开新终端,或~/.local/bin不在 PATH。- PowerShell 报
&&不是合法分隔符:你把 CMD 的安装命令贴进了 PowerShell,改用irm那条。 - CMD 说不认识
irm:那是 PowerShell 命令,换到带PS的窗口。 - 能聊天但不能用 Claude Code:仍是 Free。到定价页升级 Pro 或以上。
- 明明买了 Pro,账单却走 API:检查
ANTHROPIC_API_KEY,/logout后改用订阅登录。 - 注册页直接说地区不可用:账号不在支持范围内。不要换着邮箱反复撞注册策略。
- 安装出现 403、或
syntax error near unexpected token:对照 官方安装排障,并看本站 常见部署错误。
如果目标不是 Claude 订阅,而是用一把 Key 同时打 GPT、Claude、Gemini,那是另一条线:OpenRouter 教程。它不能代替上面的 claude.ai 登录。
常见问题
免费的 claude.ai 账号能用 Claude Code 吗? 不能。定价页对比表里,Free 的 Claude Code 为否;需要 Pro、Max、Team、Enterprise 或 Console。
Pro 和 API Key 有什么差别? Pro 把聊天和 Claude Code 算进同一份订阅用量。API Key 按 Console 余额扣费,环境变量被采用后会跳过订阅登录。
装完提示 command not found 怎么办? 新开终端再运行 claude --version。仍失败就检查 PATH,并用 claude doctor 看安装诊断。
浏览器登录后没有回到终端? 按 c 复制链接;若页面给出代码,贴回 Paste code here if prompted。SSH 和远程 Mac 都走这条。
第一次该让它做什么? 只改一个文件、并且你能看懂 diff 的小改动。命令保持需要批准。大仓知识图谱和 24 小时部署都留到这次跑通之后。
ZavCloud Developer Infrastructure
第一次跑通之后,长会话别和 Xcode 抢一台笔记本
模型订阅按 Anthropic 的套餐走,编译和常驻会话可以放在独享 macOS 上。
两边分开记账,远程登录用验证码贴回终端即可。