用途:在 Claude.ai 聊天环境中以编程方式操作 GitHub 仓库,支持读取文件、提交更改、创建分支与拉取请求,并用于跨会话持久化状态(如同步 DEVLOG.md)。不适用于 Claude Code 环境(应使用原生 git 命令),也不适用于只读访问(可直接用 GitHub UI 或 API)。
主要能力:read_file 读取仓库文件内容;commit_file 提交单个文件(创建或更新);commit_files 通过 Git Trees API 在一次原子提交中提交多个文件,可指定 create_branch_from 在分支不存在时自动创建;create_pull_request 创建 PR,支持 markdown 描述。所有函数通过 GitHubAPIError 报告错误(如 404、401/403、409、422 及限流)。
使用方式:需先创建 GitHub Personal Access Token(经典令牌需 repo 范围;细粒度令牌需 Contents 与 Pull requests 读写权限),并加入 Claude.ai 项目知识,文档标题为 GITHUB_API_KEY,内容为令牌;或以 API_CREDENTIALS.json 提供 {"github_api_key": "..."}。随后从 invoking_github 导入函数调用,例如 commit_file(repo="username/repo-name", path="README.md", content="...", branch="main", message="..."),或 commit_files(files=[{"path": "...", "content": "..."}], create_branch_from="main") 批量提交,再 create_pull_request(head="feature-branch", base="main", ...) 创建 PR。
适用场景:Claude.ai 聊天中的仓库内容更新、文档与日志同步、功能分支与 PR 创建、多仓库版本号统一提交等。
限制:仅面向 Claude.ai 聊天环境;无 OAuth,需手动配置个人访问令牌;仅使用 REST API,不支持 clone、pull、rebase 等 git 操作;单文件约 100MB 上限;认证用户每小时 5000 次请求;所有操作需联网。请使用描述性提交信息、优先批量原子提交、避免直接提交 main、妥善保管并定期轮换令牌。暂未提供官方定价与更多平台支持信息。