codex可自动生成带鉴权、分片、断点续传和元数据标记的完整对象存储上传链路;需预先配置云厂商(cos/oss/tos/s3)、region与endpoint,支持oauth自动绑定或手动输入加密凭证,最终生成可运行后端模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让Codex为你的后端自动接入对象存储,核心是让它理解“上传文件到云上”不只是调用一个SDK,而是要生成带鉴权、分片、断点续传、元数据标记能力的完整上传链路。你不需要手写OSS/COS/S3客户端代码,只要明确告诉Codex目标云厂商和使用场景,它就能自动生成可运行的后端模块。
确认对象存储服务与接入方式
先判断你用的是哪家云的对象存储:腾讯云COS、阿里云OSS、火山引擎TOS、还是AWS S3兼容服务。Codex对这四类均有预置适配器,但【必须在首次配置时声明region和endpoint,否则生成的签名URL会失效】。例如,若用腾讯云COS,需提供Bucket所在地域(如ap-beijing)和对应接入域名(cos.ap-beijing.myqcloud.com);若用火山引擎TOS,则必须填写cn-beijing.tos.volcengineapi.com——不同地域域名不互通,填错将导致403 Forbidden。
这一步不做验证,后续所有生成逻辑都基于此假设,错误无法回滚。
通过Codex插件启用对象存储支持
打开Codex桌面App → 左侧插件栏搜索“Object Storage” → 点击启用 → 弹出配置面板。
方法一:OAuth自动绑定(仅限腾讯云、阿里云官方控制台已登录状态)
点击“Connect via Cloud Console”,Codex会跳转至对应云平台授权页,允许其读取Bucket列表并申请临时上传权限(STS Token)。授权成功后自动回填Endpoint、Region、默认Bucket名。
方法二:手动输入凭证(全平台通用)
粘贴AccessKey ID、SecretKey、Bucket名称、Region、Endpoint;【SecretKey一旦粘贴即被加密存入本地密钥环,不可导出,误填需重置插件配置】。
生成带对象存储能力的后端模块
在新建项目对话框中输入需求,例如:
“创建一个用户头像上传接口,要求:接收multipart/form-data,校验图片格式和大小(≤5MB),上传至COS指定bucket的avatar/子目录,返回永久可访问的HTTPS URL,并记录原始文件名和URL到SQLite数据库。”
Codex识别到“上传”“COS”“HTTPS URL”等关键词后,自动触发Object Storage Skill流程:
- 第一步:生成独立上传服务模块(upload_service.py),封装分块上传、MD5校验、失败重试逻辑;
- 第二步:注入CosClient初始化代码,自动加载插件中配置的凭证与Endpoint,禁用全局HTTP代理(避免工控机环境代理污染);
- 第三步:为FastAPI路由添加/upload/avatar接口,绑定文件校验中间件和CosUploader依赖;
- 第四步:生成数据库模型UserAvatar,含file_key(COS Object Key)、url(预签名或公开URL)、uploaded_at字段;
- 第五步:在main.py中注册upload_service并挂载路由,同时注入健康检查端点/health/storage,用于探测COS连通性。
生成完成后,Codex会在终端自动执行pip install qcloud_cos_sdk(或其他对应SDK),并提示“对象存储模块已就绪,可启动调试”。








