用 GitHub CLI 浏览器登录并克隆公开仓库

目标与适用环境

本文介绍在 GitHub.com 上通过浏览器完成 GitHub CLI（gh）认证，再把 GitHub 官方公开仓库 cli/cli 克隆到本地目录。适用于已安装 GitHub CLI、可打开浏览器且网络可访问 GitHub 的 Windows、macOS 和 Linux 终端。

本教程关联站内 GitHub CLI v2.102.0，但官方命令手册为滚动文档，本文没有在该固定版本或三种操作系统上实机测试。以下步骤是依据 GitHub CLI 官方手册整理。它们不创建、修改或删除远端仓库内容；克隆会在本机写入文件。

准备工作

• 已安装 GitHub CLI；安装方法因系统和发行版而异，可从官方安装页选择对应方式。
• 能在终端打开浏览器，并能访问 GitHub.com。
• 选择一个尚不存在的本地目录名，例如 github-cli-src。如果目标目录已存在，先确认内容并另选目录，不要直接覆盖或清理未知文件。
• 浏览器认证过程可能显示一次性验证码。只在 GitHub 官方页面输入，不要把验证码、令牌或认证状态截图、粘贴到聊天或公开文档中。

操作步骤

1. 检查命令是否可用

打开终端，运行：

gh --version

如果显示版本信息，继续下一步。若提示找不到命令，检查安装是否完成、终端是否使用了正确的 PATH；安装后重新打开终端再试。不要从非官方来源下载替代程序。

2. 启动浏览器认证

运行：

gh auth login --web

按终端提示选择 GitHub.com 和建议的认证选项。命令会引导你在浏览器中完成授权；只在官方 GitHub 页面操作。不要使用 --with-token，不要把个人访问令牌放进命令、脚本或命令历史。

GitHub CLI 通常把令牌存入系统凭据库。如果找不到凭据库或无法使用，CLI 可能退回明文文件存储。不要用 --insecure-storage 强制明文保存。完成后可检查下一步的状态提示；若显示明文存储位置，停止在共享设备上继续认证，并先按系统的凭据管理方式处理存储风险。环境变量中的认证令牌也可能被 CLI 使用，因此不要在共享终端设置或展示令牌。

3. 本机检查认证状态

运行：

gh auth status

确认目标主机是 github.com，且状态显示已认证。输出可能包含账号、主机或凭据存储位置；只在自己的设备上查看，不要原样公开。如果状态提示认证未完成，重新运行 gh auth login --web 并按终端错误提示检查浏览器与网络，不要复制令牌求助。

4. 克隆公开仓库到新目录

先确认当前工作目录中不存在 github-cli-src，然后运行：

gh repo clone cli/cli github-cli-src

这里的 cli/cli 是 GitHub CLI 的公开官方仓库，第二个参数指定本地目录名。需要更换位置时，把第二个参数改成一个你有权限写入且尚不存在的目录路径。此操作下载仓库副本到本地，不会向远端提交更改。

5. 检查克隆结果

命令成功完成后，确认新目录 github-cli-src 已创建，且其中包含仓库文件（例如 README.md）。若要进入该目录，可使用终端对应的目录切换命令。官方手册示例显示克隆成功会输出类似 “Cloning into …” 的提示；此处不代表本教程已实际运行命令。

常见问题与恢复

浏览器认证页面打不开怎么办？ 检查网络连接和默认浏览器；确认终端显示的是 GitHub.com 的设备授权流程。不要把验证码发给他人。如果设备网络受限，停止操作并改在可信网络环境中重试。

gh auth status 显示未认证或主机不对怎么办？ 再次运行 gh auth login --web，确认选择 GitHub.com。若配置了多个主机或账号，先阅读官方 gh auth status 与 gh auth switch 手册，再决定要切换的对象。

认证成功但克隆失败怎么办？ 检查仓库名称是否为 cli/cli，网络是否可达，以及本地目标目录是否已存在。不要为了公开仓库克隆而创建令牌或扩大权限。目录已存在时，保留其内容并改用另一个新目录；不要直接删除不确定的目录。

如何结束本机认证？ 若确实不再需要此设备上的 GitHub CLI 凭据，可先确认当前主机与账号，再运行 gh auth logout --hostname github.com 并按提示确认。退出会移除本机 CLI 对该主机的认证，不会删除 GitHub 账号或远端仓库；共享设备上应按组织设备政策清理凭据。执行前确认没有其它本机工作流依赖该认证。

来源与核验范围

以下官方滚动手册于 2026-10-16（Asia/Shanghai）核验可访问并用于整理步骤；它们没有声明覆盖站内固定版本 v2.102.0。本教程未执行 CLI、浏览器登录或仓库克隆，未对三种操作系统做实测。

• gh auth login 官方手册：浏览器认证、凭据存储回退和认证选项。
• gh auth status 官方手册：认证状态检查。
• gh repo clone 官方手册：OWNER/REPO 形式及自定义本地目录。
• gh auth logout 官方手册：退出本机认证。
• GitHub CLI 官方安装页：按操作系统选择安装方式。