必须使用官网下载的macos原生客户端安装，要求系统为macos 12及以上，apple silicon或intel芯片需匹配对应架构安装包，并授权完全磁盘访问与辅助功能权限，登录实名认证百度账号后方可调用核心api。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Mac上安装文心快码（Baidu Comate）——百度智能云推出的AI编程助手，必须使用官方提供的macOS原生客户端，不能通过网页或iOS应用替代，且不支持Rosetta转译运行于Apple Silicon芯片的旧版二进制包。
确认系统与环境是否满足前提
打开“关于本机”→点击“系统报告”→在“软件”栏查看macOS版本：必须为【macOS 12 Monterey及以上】，低于此版本将无法启动安装后程序；同时检查“硬件”→“处理器”，M1/M2/M3芯片机型需确保已启用“允许从识别开发者下载的App”（系统设置→隐私与安全性→完全磁盘访问→勾选Comate安装器）。
终端中执行 arch 命令，输出应为 arm64（Apple Silicon）或 x86_64（Intel），二者均支持，但安装包必须严格匹配——官网下载页会自动识别并推送对应架构版本。
从百度智能云官网下载安装包
打开 Safari 或 Chrome，访问 https://www.php.cn/link/28847f396305d905bc678a7288ceb1a2，滚动至页面底部“下载中心”区域。
点击“macOS 客户端”按钮，下载文件名为 comate-macos-arm64.dmg（M系列芯片）或 comate-macos-x64.dmg（Intel芯片），【切勿点击旁边标有‘Beta’或‘Legacy’字样的链接】，这些版本未通过Apple公证，系统将阻止安装。
下载完成后，前往“访达”→“下载”，双击该 .dmg 文件挂载磁盘映像，窗口中会出现拖拽式安装图标和“安装说明.txt”。
安装并授权必要系统权限
将 Comate 图标拖入“应用程序”文件夹；若提示“已损坏，无法打开”，说明未开启开发者信任——立即前往“系统设置”→“隐私与安全性”→下滑到底部，点击“仍要打开”。
首次启动时，系统会弹出三项关键授权请求：
① 允许“完全磁盘访问”：必需，否则无法读取项目文件夹中的代码；
PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合在macOS系统上进行 Python 项目开发、运行、调试和测试。
② 允许“辅助功能”：必需，用于自动聚焦编辑器、模拟快捷键操作；
③ 允许“屏幕录制”：仅当启用“代码演示录制”功能时才需开启，可暂缓勾选。
三项中前两项必须立即授权，否则Comate将无法解析本地工程结构，对话框持续显示“正在扫描代码库…”且无响应。
登录并绑定百度智能云账号
启动 Comate 应用，在登录界面选择“百度账号登录” → 输入已实名认证的百度账号（非邮箱注册号，需绑定手机号）。
若账号未开通百度智能云服务，将跳转至开通页；此时需完成企业认证或个人实名（耗时约2分钟），【未完成实名的账号无法调用Comate核心代码生成API】。
登录成功后，顶部菜单栏出现“Comate”→“偏好设置”→“模型服务”，默认使用ERNIE-4.5-Turbo，无需手动切换；如需调用私有化部署模型，须在此处填写自定义Endpoint及API Key。
配置VS Code插件联动（可选但推荐）
打开 VS Code，进入扩展商店，搜索“Baidu Comate”并安装官方插件（发布者为“Baidu Cloud”）。
重启 VS Code，在任意代码文件中右键→选择“Ask Comate”，此时会触发本地Comate客户端唤醒并建立IPC通道；若提示“无法连接本地服务”，请返回Comate主界面→“设置”→“开发工具集成”→确保“启用VS Code桥接服务”已开启，并确认端口 9090 未被其他进程占用。
这一步完成后，VS Code内所有快捷键（如 Cmd+K → Cmd+I）将直接调用本地Comate引擎，响应速度比网页版快 3倍以上。
