AI Agent / 系统课时
登录认证与版本维护
登录认证与版本维护
安装完成只说明本机可以启动 Claude Code,还需要选择账号或 API 认证方式,并建立可重复的版本维护流程。本课将完成登录、状态检查、诊断、更新和退出登录,最后给出一套最小验收清单。
学习目标
- 完成订阅账号或 Console 账号认证
- 检查认证状态与安装健康
- 按安装来源选择正确的更新命令
选择认证方式
常见方式包括具有 Claude Code 权限的 Claude 订阅账号、Anthropic Console 账号,以及组织配置的受支持云服务。个人学习通常使用订阅账号;按 API 用量计费或团队集中管理时,可使用 Console 或组织指定方式。
不要把 API 密钥写进项目源码、提交到 Git 或粘贴到公开日志。使用环境变量时,也应由 Shell、凭据管理器或部署平台安全注入。
交互式登录
安装后在项目目录启动:
claude预期结果是进入交互会话;首次运行时会引导打开浏览器完成登录。认证成功后回到终端即可继续。也可以显式启动登录流程:
claude auth login预期结果是打开或显示认证流程,并在成功后保存当前用户凭据。使用 Anthropic Console 进行 API 用量计费时可运行:
claude auth login --console预期结果是进入 Console 账号认证流程,而不是订阅账号流程。
检查认证状态
使用人类可读格式检查:
claude auth status --text预期结果应说明当前已登录及认证来源;若未登录,命令会返回非零退出码。脚本需要稳定判断时可使用 JSON 输出:
claude auth status预期结果是合法 JSON,并通过退出码区分状态:已登录为 0,未登录为 1。字段可能随版本扩展,自动化脚本不应依赖未承诺的展示文本。需要切换账号或清理本机登录时运行:
claude auth logout预期结果是本机当前 Anthropic 认证被清除,随后 claude auth status 返回未登录状态。
版本与诊断
先记录版本,再运行只读诊断:
claude --version
claude doctor预期输出示例:
<VERSION> (Claude Code)
安装、设置和更新状态检查完成;无阻断项或给出修复建议如果已经进入交互会话,也可以使用 /doctor 检查安装、设置、扩展和上下文状态。Shell 中的 claude doctor 适合程序无法正常进入会话时使用。
按安装来源更新
原生安装通常会后台检查更新,也可以立即执行:
claude update预期结果是升级到新版本,或提示当前已经是最新版本。更新生效后重新启动会话,再检查 claude --version。
Homebrew、WinGet、apt、dnf 和 apk 默认由各自包管理器维护。不要看到 claude update 就假设所有安装方式都会被它接管。常用命令如下:
Homebrew: brew upgrade claude-code
WinGet: winget upgrade Anthropic.ClaudeCode
apt: sudo apt update && sudo apt upgrade claude-code
dnf: sudo dnf upgrade claude-code
apk: apk update && apk upgrade claude-code这是命令对照表,不应整块复制到同一个终端执行。选择与你实际安装来源对应的一行,预期结果是包升级或提示无可用更新。
最小验收清单
完成认证和维护后,应确认:
command -v claude或 Windows 的Get-Command claude指向预期安装。claude --version能稳定输出版本。claude doctor没有未处理的阻断项。claude auth status --text显示正确账号来源。- 在测试仓库启动
claude后能够读取项目并正常退出。
若认证反复跳转、出现 403 或组织被禁用,不要反复重装程序。此类问题应优先检查账号权限、组织策略、代理和认证回调网络。