Codex可通过Google Drive插件直接读写云端文档。需先安装Codex CLI，再安装google-drive插件（ID不可更改），配置OAuth 2.0凭据并授权，之后用codex drive read/write/append命令操作文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Linux服务器上让Codex直接读写Google Drive中的文档，省去下载→本地处理→再上传的冗余步骤，尤其适合批量处理科研报告、自动归档会议纪要或实时同步项目文档。
前提：确认Codex CLI已安装并可运行
执行codex --version，输出版本号（如v0.12.3）即表示基础环境就绪。若报错“command not found”，需先完成Codex终端CLI安装——根据你的发行版执行对应Node.js安装命令，再运行npm install -g codex-cli全局安装。
这一步不可跳过。Codex插件机制依赖CLI底层通信，未安装CLI时，后续所有插件配置将无法注册到运行时上下文。
安装Google Drive插件（仅限Codex v0.11.0+）
方法一：通过Codex内置插件市场安装
在终端中执行：codex plugin install google-drive。该命令会自动拉取最新兼容版本插件包，并注入到Codex插件注册表。
方法二：手动安装指定版本（适用于内网或版本锁定场景）
下载插件压缩包（如codex-google-drive-v0.4.2.tgz）→解压到~/.codex/plugins/目录→确保manifest.json存在且entrypoint字段指向index.js→执行codex plugin reload触发重新扫描。
【插件ID必须为google-drive】——Codex识别驱动器能力依赖硬编码ID，改名或使用别名会导致权限申请失败、认证流程中断。
配置Google OAuth 2.0凭据
第一步：访问Google Cloud Console → 新建项目（或选择已有项目）→ 启用Google Drive API。
第二步：创建OAuth凭据 → 应用类型选“桌面应用” → 设置重定向URI为http://localhost:8080/callback → 下载生成的credentials.json文件。
第三步：将credentials.json保存至~/.codex/plugins/google-drive/目录，重命名为client_secret.json。Codex插件启动时会严格查找此路径与文件名。
注意：若重定向URI填写错误（例如用了https或端口非8080），授权页面将显示“Error 400: redirect_uri_mismatch”，此时必须回控制台修改后重新下载凭据文件。
首次授权并绑定账户
执行codex drive auth命令。
在 Linux 上使用 rclone + gog OAuth 配置 Google Drive 挂载。适用于将 Google Drive 挂载为本地文件系统、设置开机自动挂载或进行其他相关配置。
终端会打印一个本地监听地址（如http://localhost:8080）并自动打开浏览器；若未自动打开，请手动粘贴该地址。
页面加载后点击“允许”，Google将返回授权码；Codex CLI捕获该码后，自动向Google请求access_token和refresh_token，并安全存入~/.codex/plugins/google-drive/token.json。
这一步完成后，token.json即成为长期凭证。只要不主动执行codex drive revoke，后续所有读写操作均无需再次扫码或登录。
读取云端文档内容
执行codex drive read "实验报告Q2.md"，Codex将按名称精确匹配Google Drive根目录下的同名文件（区分大小写）。
若需读取子文件夹中文件，路径格式为"项目/周报/6月15日.md"，斜杠必须为英文半角，且整个路径需用双引号包裹。
读取成功后，内容直接输出至终端stdout，可配合管道继续处理：codex drive read "README.md" | grep "version"。
写入或更新文档到Drive
方法一：覆盖写入（推荐用于脚本自动化）
执行codex drive write "notes.txt" --content "今日会议结论：1. 接口协议升级；2. 文档模板更新。"。若文件已存在，则内容被完全替换；若不存在，则新建。
方法二：追加写入（适用于日志类场景）
执行codex drive append "log.md" --content "$(date +%Y-%m-%d)：任务执行完成"。该操作仅在文件末尾添加新行，不改动原有内容。
【写入目标必须是纯文本文件】——Codex当前插件不支持直接写入.docx、.xlsx等二进制格式，尝试写入将导致HTTP 400错误并返回空响应体。
