邮箱里躺着 37 封未读邮件，Drive 里有三个版本的报价单，客户刚好又追问了一句：“最终方案以哪份为准？”
过去，这类任务麻烦的地方并不是写一封邮件，而是要在多个页面之间来回找信息：翻邮件线程、核对文档更新时间、确认负责人意见，再拼出一封不出错的回复。
Claude 接入 Gmail 和 Google Drive 后，真正节省的正是这段“找资料、对上下文、组织答案”的时间。你可以让它先搜索邮件，再读取 Drive 文档，整理出结论，最后生成回复；涉及发送、移动、共享或删除等操作时，再由人确认。
本文分成两层：
- 普通用户路线：直接使用 Claude 的 Google Workspace 原生连接器，不写代码；
- 开发者路线：使用 Gmail API、Drive API 和 apito.ai 搭建自己的邮件 Agent，把审批、日志和业务规则掌握在自己手里。
如果你只是想把每天的邮件处理快一点，做到前半篇就够了。如果你想让它接入 CRM、工单或内部知识库，再继续看后半篇。
一、先说清楚：Claude 现在到底能做什么
截至 2026 年 8 月，Anthropic 的 Google Workspace 连接器覆盖 Gmail、Google Calendar 和 Google Drive。本文只讨论 Gmail 与 Drive。
| 能力 | 可以做什么 | 需要注意什么 |
|---|---|---|
| Gmail 搜索与阅读 | 用自然语言找邮件、读取线程、查看附件元数据 | 能看到附件信息，不等于能直接读取附件正文 |
| Gmail 写操作 | 起草、发送、回复、转发，管理标签与线程 | 默认会在执行前要求批准；组织管理员可配置策略 |
| Drive 检索 | 搜索 Docs，读取 Sheets、Slides、PDF、图片和 Office 文件 | Google Drive 文档中的嵌入图片不会作为正文处理 |
| Drive 写操作 | 上传、移动、共享、删除文件，创建文件夹 | 默认需要批准，删除和共享尤其应保留人工确认 |
| 结果追溯 | 回答中显示引用，并尽量提供原始邮件或文档链接 | 仍需核对关键金额、日期、收件人和权限范围 |
这里有两个容易误解的地方。
第一，连接器不是“把整个邮箱交给模型随便操作”。Claude 只能访问你授权的 Google 账号及其原有权限，写操作默认还会出现批准步骤。
第二，原生连接器与 API 接入是两条路线。在 Claude 网页或桌面端连接 Gmail，不需要 apito.ai；只有当你要开发自己的 Agent、自己管理模型调用与业务流程时，才进入 API 路线。
二、零代码接入：5 分钟连接 Gmail 和 Google Drive
第 1 步：在 Claude 中找到连接器
打开 Claude 网页版或 Claude Desktop，进入连接器设置，选择 Gmail 和 Google Drive，然后登录需要授权的 Google 账号。
如果你使用 Team 或 Enterprise 计划，但列表里找不到连接器，先不要反复退出登录。更常见的原因是组织 Owner 或 Primary Owner 尚未在组织层开启连接器。
第 2 步：检查授权账号
很多人的浏览器同时登录了个人 Gmail、公司 Workspace 和测试账号。授权完成后，先确认连接的是哪一个账号，避免把个人邮件当成工作资料，或者把测试结果写进正式 Drive。
建议第一次只连接一个低风险账号，并准备：
- 一封可搜索的测试邮件；
- 一份不含敏感数据的 Drive 文档；
- 一个用于测试保存文件的新文件夹。
第 3 步：先做只读验证
不要一上来就让 Claude 发邮件。先用下面这条提示词检查搜索和引用是否正常：
搜索过去 7 天主题中包含“项目周会”的 Gmail 邮件，只列出发件人、日期、主题和每封邮件的一句话摘要。请提供来源引用，不要发送、回复、移动或修改任何邮件。
通过标准不是“Claude 给了回答”，而是以下四项都对：
- 邮件日期与发件人准确；
- 没把相似主题的旧邮件混进来；
- 引用可以回到原始内容；
- 没有执行任何写操作。
第 4 步：再验证 Drive
在 Google Drive 中查找名称含“Q3 方案”的文件，按最近修改时间排序。比较最新两份文档的目标、预算和交付时间，只根据文件内容回答，并附上原文链接。不要移动、分享或删除文件。
如果文档主要由截图、扫描页或复杂图表组成，Claude 可能只能提取有限的文本。此时应先做 OCR，或把关键图表单独提供给支持视觉理解的工作流。
三、4 个当天就能用的工作流
工作流 1：把未读邮件变成一张待办表
检索我过去 24 小时内收到的未读工作邮件，按“今天必须处理 / 本周处理 / 仅供知悉”分类。输出发件人、主题、截止时间、下一步动作和判断依据。不要改变已读状态，不要回复邮件。无法确定截止时间时标记“待确认”，不要猜。
这条提示词好用的关键，不是“帮我总结邮件”，而是给出了分类规则、输出字段和禁止动作。结果可以直接复制到任务管理工具，而不是得到一段看完仍不知道先做什么的摘要。
工作流 2：结合邮件线程和 Drive 资料起草回复
阅读主题为“年度续约方案”的完整邮件线程，并在 Drive 中查找被线程提到的最新版报价单。先列出客户的三个核心问题，再依据最新版文件起草一封回复。金额、日期和产品名称后附来源。只创建草稿，不要发送。
建议把“只创建草稿，不要发送”固定写进提示词。即使产品界面本身有批准步骤，任务描述里再声明一次边界，也能减少误操作。
工作流 3：把分散资料整理成项目简报
搜索 Drive 中过去 30 天修改过、与“新加坡市场”相关的 Docs、Slides 和 Sheets。输出一份项目简报：背景、当前进展、关键数字、未解决问题、负责人、下一里程碑。相互冲突的信息单独放入“待核实”部分，并分别引用来源。
这里不要要求 Claude 强行给出“唯一真相”。当两份文档互相矛盾时，最有价值的输出往往是明确指出冲突在哪里、各自来自什么时间和作者。
工作流 4：生成周报并保存到 Drive
根据本周与“Northstar”项目有关的邮件和 Drive 文件，生成一份周报，包含完成事项、风险、下周计划和待决策问题。先在对话中展示草稿，得到我确认后，再保存为文件到 Drive 的“项目周报/2026”文件夹。
保存 Claude 生成的文件需要启用代码执行和文件创建。即使具备保存能力，也建议坚持“先展示、后确认、再写入”的顺序。
四、让工作流稳定的 6 条规则
1. 搜索条件写成可验证的范围
“帮我看看最近的重要邮件”过于模糊。更稳的写法是：时间范围、发件人范围、主题关键词、是否未读、是否包含附件，至少明确两到三项。
2. 把事实和建议分栏
要求输出“邮件原文事实”和“Claude 建议动作”两个区块，避免模型的判断混进事实摘要。
3. 关键字段要求逐项引用
金额、日期、账号、合同版本、收件人都应附来源。没有来源就标记待确认，不要补全。
4. 写操作默认保留人工确认
发送邮件、共享文件、修改权限和删除文件都属于高影响操作。企业场景不建议为了少点一次按钮，就把所有确认永久关闭。
5. 不要把“能读文件”理解成“能读懂所有版式”
表格、幻灯片和扫描 PDF 的解析效果会受到格式影响。重要结论要回看原文件，尤其是嵌入图片里的数据。
6. 用专门的测试账号跑通再推广
团队上线前，准备一套测试邮件、测试文件和错误案例，验证搜索范围、审批步骤、日志和撤销方式，再逐步扩大使用人群。
五、开发者路线：用 apito.ai 搭一个可审批的邮件 Agent
原生连接器适合个人与通用办公。如果你需要下面这些能力，就更适合自建：
- 邮件进入后自动匹配 CRM 客户；
- 按公司知识库生成回复，但只保存草稿；
- 处理完成后给邮件加标签，并把结果写入工单；
- 不同部门使用不同模型、预算和权限；
- 所有读写动作保留审计日志。
在这套架构里，Google API 负责“拿到邮件和文件、创建草稿”，Claude 模型负责“理解、归纳、生成”，apito.ai 负责模型接入，业务服务负责权限、审批和日志。不要让模型直接持有不可控的长期凭据。
1. 推荐的最小架构
Gmail / Drive
↓ OAuth 最小权限
业务编排服务 ──→ 脱敏与上下文组装
↓ ↓
审批队列 apito.ai / Claude
↓ ↓
创建 Gmail 草稿 ←── 结构化建议
↓
人工检查后发送
Gmail / Drive
↓ OAuth 最小权限
业务编排服务 ──→ 脱敏与上下文组装
↓ ↓
审批队列 apito.ai / Claude
↓ ↓
创建 Gmail 草稿 ←── 结构化建议
↓
人工检查后发送
第一版不要做“自动发送”。先做到：读取指定邮件 → 查找相关 Drive 文件 → 生成结构化建议 → 创建草稿 → 人工发送。这个闭环已经能节省大量时间，同时保留最后一道安全阀。
2. 环境变量
APITO_API_KEY=你的_apito_key
APITO_BASE_URL=https://gw.apito.ai/v1
APITO_MODEL=请填写控制台当前可用的Claude模型ID
GOOGLE_CLIENT_SECRET_FILE=./client_secret.json
GOOGLE_TOKEN_FILE=./token.json
APITO_API_KEY=你的_apito_key
APITO_BASE_URL=https://gw.apito.ai/v1
APITO_MODEL=请填写控制台当前可用的Claude模型ID
GOOGLE_CLIENT_SECRET_FILE=./client_secret.json
GOOGLE_TOKEN_FILE=./token.json
模型 ID 以 apito.ai 控制台实时可见列表为准，不要把网上旧教程里的名称写死到生产环境。
3. 用模型生成“可审核的回复建议”
下面只演示模型层。Google OAuth、邮件检索和草稿创建应分别封装，并使用 Google 官方客户端库。
import json
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["APITO_API_KEY"],
base_url=os.getenv("APITO_BASE_URL", "https://gw.apito.ai/v1"),
)
def build_reply_plan(email_text: str, drive_context: str) -> dict:
response = client.chat.completions.create(
model=os.environ["APITO_MODEL"],
temperature=0.2,
messages=[
{
"role": "system",
"content": (
"你是企业邮件助理。只能依据提供的邮件与文档工作。"
"不得虚构金额、日期或承诺。输出严格 JSON，"
"字段为 summary, facts, uncertainties, subject, body, sources。"
"body 仅用于创建草稿，绝不声称已经发送。"
),
},
{
"role": "user",
"content": f"邮件线程：\n{email_text}\n\nDrive资料：\n{drive_context}",
},
],
)
return json.loads(response.choices[0].message.content)
import json
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["APITO_API_KEY"],
base_url=os.getenv("APITO_BASE_URL", "https://gw.apito.ai/v1"),
)
def build_reply_plan(email_text: str, drive_context: str) -> dict:
response = client.chat.completions.create(
model=os.environ["APITO_MODEL"],
temperature=0.2,
messages=[
{
"role": "system",
"content": (
"你是企业邮件助理。只能依据提供的邮件与文档工作。"
"不得虚构金额、日期或承诺。输出严格 JSON，"
"字段为 summary, facts, uncertainties, subject, body, sources。"
"body 仅用于创建草稿，绝不声称已经发送。"
),
},
{
"role": "user",
"content": f"邮件线程：\n{email_text}\n\nDrive资料：\n{drive_context}",
},
],
)
return json.loads(response.choices[0].message.content)
生产环境还要增加 JSON Schema 校验、超时与重试、内容长度限制、敏感字段脱敏，以及失败时转人工队列。
4. Gmail 只创建草稿，不直接发送
Gmail API 的草稿由一封 MIME 邮件构成。下面展示关键结构，省略 OAuth 初始化代码：
import base64
from email.message import EmailMessage
def create_gmail_draft(gmail_service, to, subject, body):
message = EmailMessage()
message.set_content(body)
message["To"] = to
message["Subject"] = subject
encoded = base64.urlsafe_b64encode(message.as_bytes()).decode()
draft = {"message": {"raw": encoded}}
return (
gmail_service.users()
.drafts()
.create(userId="me", body=draft)
.execute()
)
import base64
from email.message import EmailMessage
def create_gmail_draft(gmail_service, to, subject, body):
message = EmailMessage()
message.set_content(body)
message["To"] = to
message["Subject"] = subject
encoded = base64.urlsafe_b64encode(message.as_bytes()).decode()
draft = {"message": {"raw": encoded}}
return (
gmail_service.users()
.drafts()
.create(userId="me", body=draft)
.execute()
)
创建草稿后，把 draft_id、输入邮件 ID、引用文件 ID、模型、时间和审批人写入日志。不要把完整邮件正文无限期保存在日志里。
5. 权限从只读开始
第一阶段只申请 Gmail 只读与 Drive 只读范围；确认业务确实需要创建草稿后，再增加草稿相关权限。写入 Drive、修改权限和删除文件应拆成独立能力，不能因为“以后可能用到”就一次申请齐全。
Google 将部分 Gmail 和 Drive scope 归为敏感或受限权限。面向外部用户发布应用时，可能涉及 OAuth 验证与额外安全要求，应以 Google 当前政策为准。
六、上线前验收清单
- [ ] 测试账号与生产账号隔离；
- [ ] OAuth scope 符合最小权限原则；
- [ ] 提示词明确禁止虚构与越权；
- [ ] 金额、日期、收件人和附件逐项校验；
- [ ] 默认只创建草稿，不自动发送；
- [ ] 删除、共享、移动等操作必须审批；
- [ ] 日志能追溯邮件 ID、文件 ID、模型与审批人；
- [ ] 日志不长期保存无关的完整正文与密钥；
- [ ] API 超时、限流、授权失效时能安全转人工；
- [ ] 团队成员知道如何撤销 Google 授权。
七、常见问题 FAQ
Claude 连接 Gmail 后会自动发送邮件吗？
不会因为“连接成功”就自动发送。原生连接器的发送、回复和转发默认需要批准。自建 Agent 更建议先只创建草稿，由人核对后发送。
Claude 能读取 Gmail 附件内容吗？
官方说明中，Gmail 连接器可访问附件元数据，但不包括附件内容。如果附件正文是关键资料，可将文件放入支持读取的 Drive 工作流，或单独上传处理。
为什么我的 Claude 看不到 Google Workspace 连接器？
先检查客户端是否为当前版本、账号地区与功能是否可用；Team 或 Enterprise 用户还要确认组织 Owner 已启用连接器。
Claude 能读取 Drive 里的扫描 PDF 和文档截图吗？
效果取决于文件类型和内容。官方特别说明，Drive 文档中嵌入的图片不会按正文处理。扫描件应先做 OCR，关键图表需人工复核。
原生连接器和自建 Agent 应该怎么选？
个人办公、临时检索和通用任务优先原生连接器；需要接 CRM、工单、审批、日志、部门权限或批量任务时，再自建 Agent。
apito.ai 在这套方案里负责什么？
它位于自建 Agent 的模型接入层，用于通过统一 Base URL 和 API Key 调用控制台可用模型。Gmail 与 Drive 的授权和数据操作仍由 Google API 与你的业务服务完成。
如何避免 Agent 把错误信息写进邮件？
限制资料范围、要求逐项引用、把不确定信息单列、使用结构化输出校验，并保留草稿审批。不要用一句“请准确回答”代替工程控制。
结语：先把“找资料”自动化，再考虑“替你做决定”
Claude 连接 Gmail 和 Google Drive 后，最值得先做的并不是全自动收发邮件，而是把信息搜集、版本核对、摘要整理和草稿生成连成一条可检查的工作流。
普通用户可以从只读搜索开始，逐步开放草稿与保存能力；开发团队则应把 Google 权限、模型调用、人工审批和审计日志拆成独立层。这样即使模型、接口或业务规则变化，也不会牵一发动全身。
如果你正在搭建自己的邮件或文档 Agent，可在 apito.ai 查看当前可用模型与 API 接入方式。先用测试账号跑通“读取—生成—草稿—审批”这条最小闭环，再考虑扩大自动化范围。
