最后更新:2026-11-16(Meta、Anthropic、OpenAI 官方文档均于当天查阅)
如果说 Claude 更像「会用工具的投放助理」,那 OpenAI Codex 更像「会写代码的投放工程师」:它擅长在你的代码仓库里写、改、测 Facebook Marketing API 脚本,并能以非交互方式(codex exec)接进定时任务。本文讲怎么用 Codex 把 Facebook 广告投放全流程自动化,以及哪些地方必须留给人。Claude 版本见 Claude 操作 Facebook 广告投放全流程自动化:端到端流水线。
Codex 的 5 种用法
| Codex 形态 | 在投放流程里的用途 | 关键设置 |
|---|---|---|
| Codex CLI(交互) | 写/改 Marketing API 脚本,接 MCP 查数据 | approval_policy、sandbox_mode |
| codex exec(非交互) | 定时日报、异常分析、生成调整建议 | 默认只读沙盒、–output-schema |
| Codex SDK(TS / Python) | 嵌入内部工具或 CI 流水线 | thread_start 时指定 sandbox |
| Codex Cloud | 在云端环境跑较长的开发任务 | 网络访问与密钥按需配置 |
| Codex GitHub Action | PR 里自动审脚本、跑测试 | 用 openai/codex-action 保护 API 密钥 |

Codex CLI 可通过官方安装脚本、npm(npm install -g @openai/codex)或 Homebrew 安装(Codex CLI)。Codex 的 MCP 配置保存在 ~/.codex/config.toml,也可以在受信任项目里用 .codex/config.toml,ChatGPT 桌面版、Codex CLI 和 IDE 扩展共用同一份配置(Codex MCP)。
整体流水线
| 环节 | Codex 产出 | 运行方式 | 人工节点 |
|---|---|---|---|
| 结构搭建 | create_paused.py(全部暂停) | 本地 / CI,dry-run 后执行 | 核对后在广告管理工具激活 |
| 素材上传 | upload_images.py(hash 映射) | 手动触发 | 只传审核通过的图片 |
| 日报 | daily_report.py + codex exec 摘要 | 每日定时 | 投手阅读决策 |
| 预算规则 | adrules_library 规则 JSON | 一次创建,Meta 侧执行 | 批准后才启用 |
| 日常查询 | MCP 对话 | Codex CLI | — |

第 1 步:先写 AGENTS.md,把投放规则交给 Codex
Codex 在每次任务开始前会读取 AGENTS.md:全局的 ~/.codex/AGENTS.md 加上从仓库根目录到当前目录的各级文件,越靠近当前目录优先级越高,合并后默认上限 32 KiB(AGENTS.md)。我们把投放红线写在这里:
# AGENTS.md (repo root) - rules Codex reads before every task
## Meta ads automation rules
- Only touch ad accounts listed in accounts.allowlist (our own / client-authorised).
- Read tokens from env vars (META_SYSTEM_USER_TOKEN, META_ADS_MCP_TOKEN). Never print,
log or commit them. Never put them in prompts.
- Create every campaign, ad set and ad with status=PAUSED. Never activate anything.
- Never raise a daily budget by more than 20% in one change; budgets are in cents.
- Always send X-Client-Idempotent-Key on create calls; reuse it on retries.
- Respect rate limits: back off on error codes 4, 17, 613, 80000-80014.
- Run `pytest -q` and `python -m scripts.dry_run` before proposing changes.
- Ad copy must follow Meta Advertising Standards; flag health, finance,
employment, housing, politics and gambling for human review.第 2 步:接入 Meta 广告 MCP(可选)
Meta 官方的广告 MCP 服务器地址是 https://mcp.facebook.com/ads,可配合任何支持 MCP 的 AI 客户端(Ads MCP Server)。Meta 的「连接 MCP 客户端」指南把 Codex CLI 和 Codex 应用列为已验证的客户端;使用自己的 Meta 应用 ID 时,命令如下,OAuth 回调地址需在 Meta 应用「Facebook 登录(企业版)」设置里登记(连接 MCP 客户端):
# Codex CLI: install (pick one), then add Meta's ads MCP server
npm install -g @openai/codex
codex mcp add meta-ads --url https://mcp.facebook.com/ads --oauth-client-id <META_APP_ID>
codex mcp login meta-ads # OAuth sign-in; register the printed callback URL in your Meta app
codex mcp list也可以用系统用户令牌走 Bearer 认证(Meta 支持在 Authorization: Bearer 头里传令牌,且只支持员工角色的系统用户令牌),同时用 enabled_tools/disabled_tools 和审批模式限制 Codex 能调用的工具:
# ~/.codex/config.toml (or a trusted project's .codex/config.toml)
[mcp_servers.meta-ads]
url = "https://mcp.facebook.com/ads"
bearer_token_env_var = "META_ADS_MCP_TOKEN" # Employee-role system user token, from env
tool_timeout_sec = 120
enabled_tools = [
"ads_get_ad_accounts", "ads_get_ad_entities", "ads_get_ad_preview",
"ads_get_creatives", "ads_create_campaign", "ads_create_ad_set",
"ads_create_ad", "ads_create_creative", "ads_update_entity",
]
disabled_tools = ["ads_activate_entity", "ads_delete_custom_audience"]
default_tools_approval_mode = "writes" # prompt for tools not marked read-only
[mcp_servers.meta-ads.tools.ads_update_entity]
approval_mode = "prompt" # always ask before editsdefault_tools_approval_mode = "writes" 表示对未标记为只读的工具弹出确认。更细的配置见英文篇 Codex config.toml for Meta ads MCP: approvals and guardrails。
第 3 步:让 Codex 写 Marketing API 脚本
在 Codex CLI 里描述需求,例如「按 AGENTS.md 写一个创建暂停状态广告系列、广告组、创意和广告的脚本,带 dry-run 和测试」。我们最终采用的骨架如下,关键点是:令牌只读环境变量、创建请求带 X-Client-Idempotent-Key、限流错误指数退避(Idempotent requests、Rate limiting)。
# meta_api.py - minimal Marketing API client (Python 3.10+, pip install requests)
import os, time, json, uuid, requests
API = "https://graph.facebook.com/" + os.environ.get("META_API_VERSION", "v27.0")
TOKEN = os.environ["META_SYSTEM_USER_TOKEN"] # from env / secret manager only
ACT = os.environ["META_AD_ACCOUNT_ID"] # e.g. act_1234567890
THROTTLE = {4, 17, 613, 80000, 80003, 80004, 80014} # rate-limit codes in Meta's docs
def call(method, path, params=None, data=None, idem_key=None, tries=5):
headers = {"X-Client-Idempotent-Key": idem_key} if idem_key else {}
for attempt in range(tries):
r = requests.request(method, f"{API}/{path}", headers=headers, timeout=60,
params={**(params or {}), "access_token": TOKEN} if method == "GET" else None,
data={**(data or {}), "access_token": TOKEN} if method != "GET" else None)
for h in ("X-Business-Use-Case-Usage", "X-Ad-Account-Usage", "X-FB-Ads-Insights-Throttle"):
if h in r.headers:
print(h, r.headers[h]) # log usage, back off early
body = r.json()
err = body.get("error")
if not err:
return body
if err.get("code") in THROTTLE or r.status_code >= 500:
time.sleep(min(60 * 2 ** attempt, 900)) # exponential backoff
continue # same idem_key -> no duplicates
raise RuntimeError(json.dumps(err))
raise RuntimeError("rate limited: giving up, try later")
def key(run_id, name):
"""Stable idempotency key per object, so a retry never creates a duplicate."""
return str(uuid.uuid5(uuid.NAMESPACE_URL, f"{ACT}/{run_id}/{name}"))完整的建户结构脚本见 Codex + Facebook Marketing API campaign creation pipeline;素材批量上传见 Codex 批量上傳 Facebook 廣告素材(adimages)。
第 4 步:codex exec 跑每日报表
codex exec 默认运行在只读沙盒里,适合做分析和摘要;需要写文件时再显式加 --sandbox workspace-write。--output-schema 可以让最终输出符合你给的 JSON Schema,方便下游程序读取(codex exec):
# nightly report (read-only sandbox is the default for codex exec)
python daily_report.py
codex exec --ephemeral --output-schema report_schema.json -o report.json \
"Read report_yesterday.csv. Summarise spend, CTR, CPC and results per campaign, \
list anomalies vs the 7-day average and propose (do not apply) budget changes."自动化环境里用 CODEX_API_KEY 提供密钥,而且只给 Codex 这一步,不要设成整个 CI 任务的环境变量;在 GitHub Actions 里官方建议用 openai/codex-action。日报和规则的细节见 用 Codex 写 Facebook 广告日报与预算规则脚本。
第 5 步:沙盒与审批,别给 Codex「完全访问」
sandbox_mode可选read-only、workspace-write、danger-full-access;后者只应在隔离的 CI 容器里使用(- 配置参考
- )。
approval_policy支持on-request、never或细粒度配置;旧的untrusted已不再支持,--full-auto也已取消。- 脚本先 dry-run 打印请求体,人工确认后再真正调用;所有对象以 PAUSED 创建。
权限与合规的展开讨论见繁体篇 Codex 自動化 Facebook 廣告的權限、沙盒與合規。
Codex 和 Claude 怎么配合
我们的实际做法是:Codex 负责代码(脚本、测试、CI),Claude 负责对话式操作和长文分析(读报表、写方案、在 MCP 里起草结构)。两者都通过 Meta 官方接口操作同一个企业自有广告户,权限分开:Codex 的脚本用一个系统用户,Claude 的 MCP 连接用另一个员工角色系统用户,出了问题容易追溯。
熊猫出海如何用 Claude、Codex 和 Facebook 广告户提升客户投放效率
这篇讲的是 Codex,但在实际服务中,熊猫出海会把 Claude、Codex 和 Facebook 企业广告户组合起来,帮助出海企业更快完成「建户 → 搭结构 → 上素材 → 看数据 → 调预算」这一整套重复工作,把投放团队的时间留给策略和素材判断。
- 广告户:使用企业自己的 Facebook 广告帐号,或通过熊猫出海的开户服务合规开通的企业户;帐号归企业所有,不出租、不共享。
- Claude:适合读长文档与报表、写投放方案和文案初稿、通过 Meta 广告 MCP 在暂停状态下起草广告结构、按规则做异常排查。
- Codex:适合写和维护自动化脚本(Marketing API、Insights 日报、批量上传、预算规则),在沙盒里运行并接入定时任务或 CI。
- 人工把关:所有会花钱的动作(激活广告、提高预算)都由投手审核后执行;Meta 广告政策与素材合规由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。想了解开户与代投放流程,请看 Facebook 海外企业户开户与投放(熊猫出海服务页)。
常见问题
Codex 能直接登录我的 Facebook 广告后台吗?
不需要也不应该。Codex 通过 Marketing API 或 Meta 广告 MCP 操作,凭证是系统用户令牌或 OAuth 授权,而不是你的个人帐号密码。
codex exec 会不会误改广告?
默认是只读沙盒;再加上 AGENTS.md 规则、MCP 工具白名单和审批模式,以及脚本只建暂停对象,风险可控。
Codex 需要什么帐号?
可用 ChatGPT 登录或 OpenAI API 密钥;自动化场景官方建议用 API 密钥。OpenAI 只向支持国家/地区提供服务,开通见 ChatGPT API 怎么购买?企业开通 OpenAI API。
Meta 广告 MCP 支持 Codex 吗?
Meta 说明该服务器可配合任何兼容 MCP 的 AI 客户端;Codex CLI 支持 Streamable HTTP 的 MCP 服务器和 OAuth/Bearer 认证。
脚本跑着跑着报 613 怎么办?
这是限流。同一对象每 30 秒只能改一次,同一广告组预算每小时最多改 4 次,按错误子码退避即可。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的广告帐号、主页与像素,通过 Meta 官方 Marketing API、Ads MCP 服务器或 Ads CLI 接入,使用业务管理平台(Business Manager)中的系统用户与最小权限,遵守 Meta 速率限制与《广告发布标准》,并在任何会产生花费的操作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐号、BM 或 API 密钥,不协助规避广告审核、地区限制、KYC、企业验证或支付管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- Facebook 海外企业户开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- 用 Codex 写 Facebook 广告日报与预算规则脚本
- Claude 操作 Facebook 广告投放全流程自动化:端到端流水线
- 如何将 Claude 链接到 Facebook 广告(Meta 广告 MCP 教程)
- Meta 开发了 MCP:让 AI 直接操作你的广告投放
- MCP 安全指南:AI Agent 工具调用权限最小化
- 大模型 API Key 申请与安全管理
- Meta Marketing API v27.0 更新解读
联系熊猫出海:Facebook 开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(建户结构、素材、日报还是预算规则)。我们先做资质与素材预审,再协助开通合规的 Facebook 企业广告户,并用 Claude、Codex 搭建在你自有帐号上运行的自动化流程。我们不出售、出租或共享任何广告帐号。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- OpenAI: Codex CLI
- Meta: Connect an MCP client to Meta
- OpenAI: Codex and MCP
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Codex configuration reference
- OpenAI: Codex SDK
- OpenAI: Codex GitHub Action
- Meta: Ads MCP server overview
- Meta: Ads MCP server – get started
- Meta: Idempotent requests
- Meta: Marketing API rate limiting
- OpenAI: Supported countries and territories
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
