用途:让云端 AI 编码代理通过 gh CLI 与 GitHub 交互,包括创建/查看/合并 PR、管理 issue、调用 GitHub API 及处理 releases。
环境差异:Claude Code 云端(claude.ai/code)默认镜像未预装 gh,需安装并配置令牌;GitHub Copilot 编码代理已预装 gh,只需认证。
Claude Code 云端做法:在 Environment Settings 的 Setup script 中运行: apt update && apt install -y gh 并将 GH_TOKEN(GitHub PAT,需 repo 权限)设为环境变量。仓库可移植方案是在 .claude/settings.json 配置 SessionStart hook,并以内置的 CLAUDE_CODE_REMOTE 判断仅在云会话执行。因沙箱代理,建议使用 -R owner/repo 标志,例如: gh pr create -R codervisor/myrepo --title "..." --body "..."
Copilot 代理做法:在仓库添加 .github/copilot-setup-steps.yml,通过 GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} 认证,提交推送后代理会话自动加载。
常用命令:gh pr create/list/view/merge、gh issue list/view/create、gh api(覆盖子命令未支持的功能)。
限制与排错:"command not found" 表示未安装;HTTP 401 表示 GH_TOKEN 未设置;HTTP 403 表示令牌缺少 repo 权限;"could not determine repo" 需加 -R 标志;PR 创建失败可先 git push -u origin <branch>;Setup script 失败需确认网络为 Limited 或 Full。使用方法可通过 npx skills add -g onsager-ai/dev-skills --skill github-integration -a claude-code -y 安装激活。