Skip to content

setup-git-auth.md

Latest commit

 

History

History
124 lines (94 loc) · 3.49 KB

setup-git-auth.md

File metadata and controls

124 lines (94 loc) · 3.49 KB

🔐 配置Claude Flow自动Git提交认证

为了让Claude Flow能够自动提交代码到GitHub，需要配置认证信息。推荐使用**Personal Access Token (PAT)**方式。

📋 步骤指南

1. 创建GitHub Personal Access Token

  1. 访问GitHub设置页面：

  2. 创建新Token：

    • 点击 "Generate new token" → "Generate new token (classic)"
    • 或者选择 "Fine-grained tokens" (更安全，推荐)

  3. 配置Token权限：

    Token名称: Claude Flow Auto Commit
过期时间: No expiration (或选择合适的时间)

权限勾选：
✅ repo (完整仓库访问权限)
  ├── repo:status
  ├── repo_deployment  
  ├── public_repo
  └── repo:invite
✅ workflow (如果需要触发GitHub Actions)

  4. 生成并复制Token：

    • 点击 "Generate token"
    • ⚠️ 重要：立即复制Token，页面关闭后无法再查看
    • Token格式类似：ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 配置本地Git认证

方法A：使用Git Credential Helper (推荐)

# 配置用户信息
git config --global user.name "aikenchen0-ctrl"
git config --global user.email "your-email@example.com"

# 配置认证信息 (一次性设置)
git config --global credential.helper store

# 第一次推送时会要求输入认证信息
git push origin main
# Username: aikenchen0-ctrl  
# Password: 输入你的PAT (不是GitHub密码！)

方法B：直接在远程URL中包含Token (方便但不够安全)

# 修改远程仓库URL包含Token
git remote set-url origin https://aikenchen0-ctrl:YOUR_PAT_TOKEN@github.com/aikenchen0-ctrl/zhiFa.git

# 立即测试推送
git push origin main

方法C：使用环境变量 (最安全)

# 在 ~/.zshrc 或 ~/.bashrc 中添加
echo 'export GITHUB_TOKEN=your_pat_token_here' >> ~/.zshrc
source ~/.zshrc

# 使用脚本推送
git push https://$GITHUB_TOKEN@github.com/aikenchen0-ctrl/zhiFa.git main

3. 验证配置

测试自动推送是否工作：

# 创建一个测试提交
echo "测试自动提交 $(date)" >> test.txt
git add test.txt
git commit -m "🧪 测试自动Git推送配置"
git push origin main

如果推送成功，说明认证配置正确！

4. Claude Flow集成

配置完成后，Claude Flow将能够：

  • ✅ 自动执行 git add .
  • ✅ 自动执行 git commit -m "..."
  • ✅ 自动执行 git push origin main
  • ✅ 触发GitHub Actions自动部署
  • ✅ 您的手机立即能访问更新

⚠️ 安全提醒

  1. 保护Token安全：

    • 不要在代码中明文写入Token
    • 不要截图或分享包含Token的内容
    • 定期轮换Token

  2. 最小权限原则：

    • 只赋予必要的权限
    • 可以为不同项目创建不同Token

  3. 监控使用情况：

    • 在GitHub Settings中监控Token使用情况
    • 如发现异常立即撤销Token

🚨 如果Token泄露

  1. 立即前往 https://github.com/settings/personal-access-tokens/tokens
  2. 点击泄露的Token旁边的 "Delete"
  3. 重新生成新的Token
  4. 更新本地配置

📞 需要帮助？

如果配置过程中遇到问题：

  1. 检查Token权限是否正确
  2. 确认用户名和Token都输入正确
  3. 检查仓库是否存在且有推送权限
  4. 查看Git错误信息获取具体问题

配置完成后，Claude Flow就能实现完全自动化的代码提交和部署了！🎉