必须在任务创建时明确指定HTTPS格式的完整仓库地址和已存在的远程分支,且GitHub账号需预先授权repo与workflow权限;Codex Cloud不支持新建仓库或分支。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Codex 中为云端任务指定具体代码仓库,必须在任务创建时明确声明目标仓库地址与分支,不能依赖本地工作区自动推断——因为云端环境完全看不到你电脑上未推送的文件或未提交的修改。
选择仓库前的必要准备
确保你的 GitHub 账号已通过 Codex Web 界面完成授权:点击侧边栏「Settings」→「Connected Accounts」→「Connect to GitHub」,完成 OAuth 流程并授予 【repo】 和 【workflow】 权限。缺少任一权限,后续将无法克隆私有仓库或创建结果 PR。
确认目标仓库已在 GitHub 上存在且可访问。Codex Cloud 不支持新建仓库,只读取已有远程仓库。
在 Codex Web 界面中手动选择仓库
进入 https://chatgpt.com/codex → 点击右上角「+ New Task」→ 选择「Cloud」执行模式。
在「Repository」输入框中,直接输入完整 HTTPS 地址,例如:https://github.com/yourname/project-x.git。不支持简写(如 yourname/project-x)或 SSH 地址(如 git@github.com:yourname/project-x.git),输错会导致克隆失败且无明确报错提示。
下方「Branch」字段默认填入 main,如需指定其他分支(如 dev 或 codex-fix-2026),请手动修改。该分支必须已在远程仓库中存在,云端不会自动创建新分支。
通过 CLI 提交任务时指定仓库
方法一:使用 --repo 参数显式传入
codex task submit --repo https://github.com/yourname/project-x.git --branch staging --script ./setup.sh
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:在任务配置 YAML 文件中声明(推荐用于复用场景)
新建 task.yaml,写入:
repository: https://github.com/yourname/project-x.git<br>branch: production<br>setup: ./scripts/install-deps.sh
然后运行:codex task submit -f task.yaml。注意:YAML 中的 repository 字段值必须带 https:// 协议头,否则解析失败。
从 Codex APP 桌面端发起云端任务时绑定仓库
第一步:在 APP 主界面点击「+ New Task」→ 选择「Run in Cloud」;
第二步:在弹出面板中点击「Select Repository」按钮 → 弹窗列出你 GitHub 账号下所有拥有 read 权限的仓库(含组织仓库);
第三步:勾选目标仓库 → 点击右侧分支下拉菜单,选择已存在的远程分支;
第四步:点击「Confirm & Continue」。此时 Codex 会立即尝试连接 GitHub API 验证该仓库可访问性,【若验证失败,界面仅显示“Failed to load”且无进一步错误说明,需检查网络代理或令牌权限】。

















