使用 Codex 自动完成 Gitee 仓库 Fork 配置

本文记录一次由 Codex 完成的 Gitee 双仓库开发环境配置。目标是在个人空间中维护机器人端与 Java Web 端的 Fork，并从指定的上游分支创建统一的功能开发分支。

整个过程中，用户只需要完成两项无法由自动化代替的授权操作：在 Gitee 页面生成私人令牌，以及将令牌保存到本机 Keychain。其余仓库操作均由 Codex 完成。

一、用户完成 Gitee 授权

1. 在 Gitee 页面生成私人令牌

进入 Gitee 的“设置 -> 私人令牌”，创建一个专门用于自动化管理仓库的令牌，并授予项目管理所需权限。

令牌只会在生成时完整显示一次，不应粘贴到聊天、代码、Git 配置或普通文本文件中。

2. 将令牌保存到 macOS Keychain

在本地终端执行一次：

security add-generic-password \
  -a gitee-user001 \
  -s codex-gitee-token \
  -w "GITEE_TOKEN" \
  -U

gitee-user001是我gitee的用户名，改成你的
GITEE_TOKEN改成你刚才复制的内容
这条命令使用以下信息保存令牌：

account: gitee-user001
service: codex-gitee-token

完成后只需告知 Codex“令牌已放入 Keychain”，不需要提供令牌内容。

二、Codex 验证 Gitee 授权

Codex 会从 Keychain 动态读取令牌，并调用 Gitee OpenAPI 验证当前授权用户：

这个指令不需要你执行，只是告诉你它怎么验证的。

TOKEN=$(security find-generic-password \
  -a gitee-user001 \
  -s codex-gitee-token \
  -w)

curl -H "Authorization: token $TOKEN" \
  https://gitee.com/api/v5/user

令牌不会出现在命令输出、项目文件或 Git 历史中。

本次配置首次验证接口返回 200，说明令牌和授权账号均有效。

三、Codex 通过 API 创建 Fork

然后你让codex帮你管理代码仓库即可

我这里Java Web 上游仓库为：

https://gitee.com/bdca/aibot.git

Codex 使用 Gitee OpenAPI 创建个人 Fork：

curl -X POST \
  -H "Authorization: token $TOKEN" \
  https://gitee.com/api/v5/repos/xxx/aibot/forks

接口返回 HTTP 201，最终仓库关系为：

上游仓库: xxx/aibot
个人 Fork: gitee-user001/aibot
默认分支: test

随后再次通过 API 验证 fork=true，并确认父仓库为 xxx/aibot。这样后续gitee相关都可以通过ai来完整，不用自己再手敲或者使用gitee desktop等工具