AI Agent / 系统课时

登录认证与版本维护

登录认证与版本维护

安装完成只说明本机可以启动 Claude Code,还需要选择账号或 API 认证方式,并建立可重复的版本维护流程。本课将完成登录、状态检查、诊断、更新和退出登录,最后给出一套最小验收清单。

学习目标

  • 完成订阅账号或 Console 账号认证
  • 检查认证状态与安装健康
  • 按安装来源选择正确的更新命令

选择认证方式

常见方式包括具有 Claude Code 权限的 Claude 订阅账号、Anthropic Console 账号,以及组织配置的受支持云服务。个人学习通常使用订阅账号;按 API 用量计费或团队集中管理时,可使用 Console 或组织指定方式。

不要把 API 密钥写进项目源码、提交到 Git 或粘贴到公开日志。使用环境变量时,也应由 Shell、凭据管理器或部署平台安全注入。

交互式登录

安装后在项目目录启动:

bash
claude

预期结果是进入交互会话;首次运行时会引导打开浏览器完成登录。认证成功后回到终端即可继续。也可以显式启动登录流程:

bash
claude auth login

预期结果是打开或显示认证流程,并在成功后保存当前用户凭据。使用 Anthropic Console 进行 API 用量计费时可运行:

bash
claude auth login --console

预期结果是进入 Console 账号认证流程,而不是订阅账号流程。

检查认证状态

使用人类可读格式检查:

bash
claude auth status --text

预期结果应说明当前已登录及认证来源;若未登录,命令会返回非零退出码。脚本需要稳定判断时可使用 JSON 输出:

bash
claude auth status

预期结果是合法 JSON,并通过退出码区分状态:已登录为 0,未登录为 1。字段可能随版本扩展,自动化脚本不应依赖未承诺的展示文本。需要切换账号或清理本机登录时运行:

bash
claude auth logout

预期结果是本机当前 Anthropic 认证被清除,随后 claude auth status 返回未登录状态。

版本与诊断

先记录版本,再运行只读诊断:

bash
claude --version
claude doctor

预期输出示例:

text
<VERSION> (Claude Code)
安装、设置和更新状态检查完成;无阻断项或给出修复建议

如果已经进入交互会话,也可以使用 /doctor 检查安装、设置、扩展和上下文状态。Shell 中的 claude doctor 适合程序无法正常进入会话时使用。

按安装来源更新

原生安装通常会后台检查更新,也可以立即执行:

bash
claude update

预期结果是升级到新版本,或提示当前已经是最新版本。更新生效后重新启动会话,再检查 claude --version。

Homebrew、WinGet、apt、dnf 和 apk 默认由各自包管理器维护。不要看到 claude update 就假设所有安装方式都会被它接管。常用命令如下:

text
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 或组织被禁用,不要反复重装程序。此类问题应优先检查账号权限、组织策略、代理和认证回调网络。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

登录认证与版本维护

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通