主题
0.5 首次启动与登录
学习目标
- 成功启动 Claude Code
- 完成 OAuth 登录授权
- 看懂首次使用的引导界面
- 看到那个让人激动的
>提示符
启动 Claude Code
打开终端（macOS 的 Terminal，Windows 的 PowerShell 或 WSL），输入：
bash
claude就这么简单，一个单词。
[截图: 终端中输入 claude 后的初始界面]
如果你用的是桌面版 App，直接双击打开就行，不需要输入任何命令。
踩坑提醒：第一次启动可能会稍微等几秒钟，这是正常的。它需要初始化一些配置。
登录授权
第一次启动 Claude Code，它会提示你登录。流程很简单：
第一步：选择登录方式
终端里会显示类似这样的提示：
Welcome to Claude Code!
How would you like to authenticate?
> Anthropic (claude.ai account)
API Key选择 Anthropic（claude.ai account） — 就是用你之前注册的那个账号登录。
[截图: 登录方式选择界面]
另一个选项 "API Key" 是给开发者用的，新手不用管。
第二步：浏览器授权
选完之后，终端会显示一行提示，同时你的浏览器会自动弹出一个授权页面。
Opening browser for authentication...
If your browser doesn't open, visit: https://claude.ai/oauth/...[截图: 浏览器弹出的 OAuth 授权页面]
在浏览器页面上，你会看到一个"允许 Claude Code 访问你的账号"之类的确认按钮。点击 Allow（允许）。
第三步：回到终端
授权成功后，浏览器会显示"授权成功，你可以关闭这个页面了"的提示。
切换回终端，你会看到登录已经完成。
✓ Successfully authenticated![截图: 终端显示登录成功的信息]
踩坑提醒：如果浏览器没有自动弹出，终端里会给你一个 URL 链接。手动复制这个链接，粘贴到浏览器地址栏打开就行。
首次引导界面
登录成功后，Claude Code 会展示一个简短的引导：
你会看到的信息
╭─────────────────────────────────────────╮
│ Welcome to Claude Code! │
│ │
│ /help - Show available commands │
│ /model - Switch AI model │
│ /cost - Check usage │
│ │
│ Tips: │
│ • Ask questions in natural language │
│ • Claude can read & write your files │
│ • Use Esc to cancel current operation │
│ │
╰─────────────────────────────────────────╯[截图: 实际的首次启动引导界面]
这个引导告诉你几个关键信息：
- 输入
/help可以看帮助 — 不会就问它 - 输入
/model可以切换模型 — 后面会详细讲 - 输入
/cost可以看花了多少钱 — 很实用 - 用自然语言提问就行 — 不需要学特殊的命令格式
- 按
Esc可以取消当前操作 — 你的"紧急刹车"
关于工作目录
Claude Code 启动时，默认的工作目录就是你运行 claude 命令时所在的目录。
什么意思？比如你在 ~/projects/my-app 目录下启动 Claude Code，那它就会把这个目录当作你的项目目录，读写文件都基于这个位置。
所以，在启动 Claude Code 之前，先 cd 到你的项目目录：
bash
# 先进入你的项目目录
cd ~/projects/my-app
# 再启动 Claude Code
claude如果你只是随便试试，在哪里启动都行。
选择权限模式
首次启动时，Claude Code 可能会问你想用什么权限模式：
- Suggest（建议模式）— Claude 只建议改动，你一个一个确认
- Auto Edit（自动编辑）— Claude 自动改文件，但运行命令前会问你
- Auto（全自动）— Claude 全自动执行，包括改文件和运行命令
新手请选 Suggest 或 Auto Edit。 等你熟悉了再切换到更自动的模式。
[截图: 权限模式选择界面]
成功标志
当你看到这样的提示符时：
>或者类似的输入光标在等你打字，恭喜你，Claude Code 已经准备就绪了。
你已经跨过了那道 99% 的人迈不过去的门槛。
从注册账号、搞定支付、安装软件、到登录启动——很多人在这个过程中就放弃了。你没有。
常见问题
Q：登录时浏览器授权页面报错怎么办？
- 确认你已经订阅了 Pro 或 Max 计划（免费版也可以体验有限额度）
- 确认你的 Anthropic 账号可以正常登录
claude.ai - 清除浏览器缓存后重试
- 换个浏览器试试
Q：授权成功了但终端没反应怎么办？
有时候授权回调会有延迟。等 10-15 秒看看。如果一直没反应：
- 按
Ctrl + C中断 - 重新运行
claude - 重新走一遍授权流程
Q：提示"subscription required"怎么办？
说明你的账号没有有效的订阅计划。回到 claude.ai 确认你已经订阅了 Pro 或更高的计划。免费版有有限额度，如果额度用完了也会出现类似提示。
Q：能不能在 VS Code 的终端里启动？
完全可以。在 VS Code 里按 Ctrl + `（反引号）打开内置终端，输入 claude 就行。实际上很多人就是这样用的——左边是 VS Code 的文件浏览器，右边是 Claude Code 的终端。
[截图: 在 VS Code 终端中运行 Claude Code]
Q：每次启动都要重新登录吗？
不需要。第一次登录后，Claude Code 会记住你的登录状态。以后直接输入 claude 就能用，不用重复授权。
小结
- 终端输入
claude就能启动 - 第一次需要通过浏览器授权登录，以后就不用了
- 启动前先
cd到项目目录 - 新手建议用 Suggest 或 Auto Edit 权限模式
- 看到
>提示符就说明一切就绪
下一节 → 你的第一次对话