Skip to content

Latest commit

 

History

History

claude-code-connect-github

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

README.md

让 Claude Code 连上你的 GitHub(图文教程)

连上之后,Claude Code(命令行版 AI 编程助手)就能帮你建仓库、上传代码、管理 issue。全程约 3 分钟,准备一台电脑 + 一个 GitHub 账号即可。

本文截图都是真实操作截下来的,里面的用户名已打码,你照着做就行。


第 0 步|先装 gh(GitHub 官方命令行)

gh 是什么:GitHub 官方出的命令行工具。Claude Code 就是通过它来读写你的 GitHub,所以得先装它。

Mac:打开「终端」App,输入下面这行,回车,等它装完:

brew install gh

Windows:去 https://cli.github.com 下载安装包,或在 PowerShell 里跑 winget install GitHub.cli。

没有 Homebrew 的话,先去 https://brew.sh 按首页那行命令装好 Homebrew,再回来装 gh。

装好后输入 gh --version,能看到版本号(比如 gh version 2.86.0)就说明成功了。


第 1 步|在终端发起连接,拿到「一次性码」

输入这行命令,回车:

gh auth login

接着它会问你几个问题,用上下箭头选、按回车确认,依次选:

  1. Where do you use GitHub?(你用哪个 GitHub)→ 选 GitHub.com
  2. What is your preferred protocol...(用哪种协议)→ 选 HTTPS
  3. How would you like to authenticate...(怎么登录)→ 选 Login with a web browser(用浏览器登录)

然后你会看到这样一行一次性码(你的码跟图里不一样):

终端显示一次性码

把这串码记下来或复制,然后按一下回车,浏览器会自动打开。


第 2 步|在浏览器里输入这串码

浏览器会自动跳到 GitHub 的输码页(没自动开就自己打开 https://github.com/login/device)。把刚才终端给你的码,填进那 8 个小格子里,点绿色 Continue:

浏览器输入一次性码

如果它先让你选账号,选你要连的那个账号就行。


第 3 步|点「授权」

接着出现 Authorize GitHub CLI 页面,确认是你本人在操作,点最下面那个绿色的 Authorize 按钮:

点击授权按钮

第一次连接时,这里可能让你再输一次 GitHub 密码、或两步验证(2FA)的 6 位码,正常输入即可。


第 4 步|回终端,确认连上了

浏览器显示成功后,回到终端,它会自动显示已登录。想再确认一下,输入:

gh auth status

看到 ✓ Logged in to github.com account ... 就说明连接成功了:

终端确认连接成功

搞定! 现在 Claude Code 就能帮你管理 GitHub 了——建仓库、传代码、改 README、发布版本、管 issue 都行。


踩坑补充(遇到再看)

  • 每次重开终端又要重新登录? 多半是 Mac「钥匙串」存不住 token 的毛病。解法:在 GitHub 生成一个永不过期的 Token(Settings → Developer settings → Personal access tokens),把它写进 ~/.zshenv 的 GH_TOKEN,一次设置、永久生效,绕开钥匙串。
  • 提示要两步验证、但找不到验证器? 用当初保存的「恢复码」(recovery codes)顶替,每个能用一次。