Superpowers开发者工具链：认知增强型AI编程工作流解析

1. 项目概述：Superpowers 不是超能力，而是开发者工具链的“认知增强套件”

“Superpowers”这个词最近在开发者社区里频繁刷屏，但别被字面意思带偏——它不是什么科幻电影里的变种人能力，也不是某个新出的AI模型代号。它本质上是一套围绕代码智能辅助工作流构建的、高度集成的开发者工具组合体，核心目标非常务实：把原本需要在多个窗口、多个命令行、多个配置文件之间反复切换的“查文档→写提示词→调API→改代码→验证结果”这一整条链路，压缩成一次鼠标点击或一句自然语言指令就能完成的动作。我第一次看到这个概念是在一个凌晨三点的GitHub issue里，一位前端工程师吐槽：“写个React组件的Props类型定义，我得先翻TypeScript Handbook，再查React官方文档，再切到TS Playground试类型推导，最后回编辑器写代码——这哪是写代码，这是在演《盗梦空间》。”而Superpowers要干的事，就是把这套“多层梦境”直接坍缩成一层现实。

从热词分布来看，“Superpowers”目前主要锚定在四个具体工具上：Claude Code、Antigravity、Codex CLI 和 Cursor。它们不是孤立存在的，而是像乐高积木一样，各自承担不同角色，共同拼出一个完整的“开发认知增强”系统。Claude Code 是那个坐在你肩膀上的资深同事，能实时理解上下文并给出精准建议；Antigravity 是你的“时间管理外挂”，自动帮你跳过那些枯燥的登录验证、环境配置、权限申请等行政性障碍；Codex CLI 是你的“命令行瑞士军刀”，把复杂的工程操作（比如一键生成Remotion动画脚本、批量重命名测试用例、根据PR描述自动生成Changelog）封装成几个简单参数；Cursor 则是整个系统的“物理载体”，它不只是一个编辑器，更是一个深度嵌入了上述所有能力的操作系统级界面。你不需要记住codex cli --model qwen2.5 --compact这样的长命令，只需要在Cursor里右键选中一段代码，说“用Qwen2.5重写这个函数，要求兼容Node.js 18”，它就自动调用Codex CLI，指定模型，执行，再把结果塞回编辑器——整个过程你甚至没看到终端窗口闪一下。

这个项目对谁最有价值？答案很明确：每天被“重复性认知劳动”压得喘不过气的中高级开发者。不是刚学Python的大学生，也不是只写SQL报表的数据分析师，而是那些已经熟练掌握框架、能独立设计架构、却总在“配环境”“调API Key”“写重复的单元测试”“给实习生解释为什么不能用any类型”这些事情上消耗掉30%以上有效工时的人。它解决的不是“会不会”的问题，而是“愿不愿花这个时间”的问题。就像当年Sublime Text的Snippet功能让写HTML不再痛苦一样，Superpowers解决的是现代开发中更高阶的“注意力税”。我上周用它重构一个遗留的Express路由模块，原来需要手动梳理17个中间件的执行顺序、检查每个req.body字段的校验逻辑、再逐个补全JSDoc，花了整整一个上午；启用Superpowers工作流后，我只做了三件事：选中整个router文件夹 → 右键 → “生成完整API文档与类型定义” → 等待12秒 → 检查生成结果。省下的时间，我用来给团队写了一份关于如何避免中间件地狱的内部分享。

2. 工具链解构：四大组件如何协同构成“Superpowers”系统

2.1 Claude Code：不是另一个Copilot，而是“上下文感知型结对编程伙伴”

很多人第一反应是：“这不就是GitHub Copilot换了个马甲？”错。Claude Code 的核心差异在于它的上下文窗口深度与语义理解粒度。Copilot 更像一个“短时记忆专家”，它能基于当前文件的几百行代码给出补全建议，但一旦涉及跨文件依赖、项目级约定（比如“所有API响应必须包含x-request-id头”）、或者业务逻辑隐含规则（比如“用户积分变更必须同步触发风控审计日志”），它的建议就开始飘忽。而Claude Code 的设计哲学是“先理解项目，再理解代码”。它会主动扫描你的tsconfig.json、eslint.config.js、package.json中的scripts字段，甚至读取.cursor/rules.md（如果你有自定义编码规范文档），把这些信息构建成一个轻量级的“项目知识图谱”。

举个真实例子：我们有个微服务项目，所有数据库查询都必须通过>rules: - name: "禁止console.log" pattern: "console\\.log\\(.*\\)" suggestion: "请改用logger.info()，参考/docs/logging-guide.md" - name: "强制类型守卫" pattern: "if \\(typeof.*=== 'string'\\)" suggestion: "请改用isString()类型守卫函数，已定义在/utils/type-guards.ts"

这些规则会被Claude Code 在分析时动态注入提示词，形成真正的“团队专属AI”。这也是为什么它比通用大模型更适合落地——它把“教AI懂业务”这件事，从每次对话的临时输入，变成了可版本控制、可Code Review、可随项目演进的基础设施。

2.2 Antigravity：不是跳过验证，而是“自动化信任链管理”

“Please verify your account to continue using Antigravity” 这句报错，是很多新手卡住的第一道墙。网上一堆教程教你“打开Google，搜索Antigravity，点官网，注册，收邮件，点链接，填手机号……”，听起来就累。但Antigravity真正的价值，根本不在“跳过验证”，而在于它把开发者最厌恶的“信任建立过程”给标准化、自动化、可审计化了。

想象一下你加入一个新项目，第一天要做的不是写代码，而是：

• 找到infrastructure/terraform/目录，执行terraform init，然后卡在“需要AWS Access Key”
• 打开secrets/.env.example，发现SLACK_WEBHOOK_URL是空的，得找运维要
• 运行npm run dev，报错“找不到REDIS_URL”，又得去Confluence查配置文档
• 最后想跑单元测试，发现jest.config.js里引用了./test-setup.local.js，而这个文件被.gitignore了……

Antigravity 干的就是把这些散落在各处的“信任凭证”和“环境契约”，统一成一个可声明、可验证、可分发的YAML文件。它不存储你的密码，而是生成一个trustchain.yaml：

providers: - name: "aws-production" type: "aws-iam-role" role_arn: "arn:aws:iam::123456789012:role/devops-deployer" region: "us-east-1" - name: "slack-alerts" type: "slack-webhook" url: "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX" channel: "#alerts-dev" validations: - name: "redis-connectivity" command: "redis-cli -u $REDIS_URL PING" expected: "PONG" - name: "database-migrations" command: "npx prisma migrate status --schema ./prisma/schema.prisma" expected: "Your database is up to date"

当你执行antigravity apply，它会：

1. 检查你本地是否拥有aws-production角色的临时凭证（通过AWS SSO或aws configure sso）
2. 如果没有，自动打开SSO登录页，完成MFA后获取凭证
3. 验证slack-webhookURL是否可访问（发送一个测试消息到#alerts-dev）
4. 执行redis-cli PING和prisma migrate status，确认所有依赖服务就绪
5. 将验证通过的环境变量（如REDIS_URL,DATABASE_URL）安全注入到当前shell会话中

整个过程无需你手动复制粘贴任何密钥，所有操作都有详细日志（antigravity log --tail），且trustchain.yaml可以提交到Git，成为团队共享的“环境可信声明”。这才是它叫“Antigravity”的原因——它不是让你无视重力（安全规则），而是给你一套可靠的反重力引擎，让你能稳定地悬浮在复杂环境之上，专注真正重要的事。我见过最绝的用法，是把trustchain.yaml和CI流水线绑定：每次PR提交，CI会自动运行antigravity validate，如果任何一个验证失败（比如测试数据库连接超时），流水线直接标红，而不是等到部署阶段才崩溃。这把“环境问题”从“发布后故障”提前到了“代码提交时预警”。

2.3 Codex CLI：不是又一个CLI工具，而是“项目语义的命令行接口”

Codex CLI 的名字容易让人误解它是某个大模型的命令行客户端。其实恰恰相反，它是一个反向的、以项目为中心的CLI。传统CLI（比如git,npm）是“你告诉工具做什么”，Codex CLI 是“你告诉项目你想达成什么效果，它来决定用什么工具、什么参数、什么顺序去执行”。

它的核心命令不是codex --model claude-3-haiku，而是像：

• codex generate api-docs --format openapi3 --output ./docs/api-spec.yml
• codex refactor legacy-code --pattern react-class-component --target react-hooks
• codex audit security --rule owasp-top10 --output ./reports/security-audit.md

这些命令背后，是Codex CLI 对你项目的一次深度“体检”。当你运行codex generate api-docs，它会：

1. 解析所有src/routes/**/*.{ts,js}文件，提取Express/Koa/Hono的路由定义
2. 扫描src/middlewares/auth.ts等文件，识别认证方式（JWT、Session、API Key）
3. 分析src/types/index.ts，提取请求/响应体的TypeScript接口
4. 结合openapi.yaml（如果存在）中的全局配置，生成符合OpenAPI 3.0规范的完整文档

整个过程你不需要指定“用哪个解析器”“从哪个文件读”，Codex CLI 自动根据项目技术栈（通过package.json的dependencies和tsconfig.json推断）选择最优策略。更厉害的是它的/compact和/resume子命令。/compact用于“压缩”一个复杂的多步骤操作为单个可复用的命令。比如你经常要：

# 步骤1：生成新组件 npx create-react-app my-component --template typescript # 步骤2：添加Storybook npx storybook@latest init # 步骤3：配置ESLint规则 cp ./templates/eslint-config-react.js .eslintrc.js

你可以运行codex compact --name create-storybook-component --steps "npx create-react-app..., npx storybook@latest init, cp ..."，之后只需codex create-storybook-component --name Header，它就自动执行全部三步。而/resume则解决中断问题：如果你在执行一个耗时的codex audit performance时电脑蓝屏了，重启后运行codex resume，它会自动从最后一个成功保存的检查点（比如“已完成Lighthouse审计，正在分析Webpack Bundle Analyzer报告”）继续，而不是从头再来。这背后是Codex CLI 内置的轻量级状态机，它把每个命令的执行过程记录为JSON-LD格式的事件流，存放在.codex/state/目录下，完全透明可审计。

2.4 Cursor：不是VS Code的克隆，而是“AI原生开发环境的操作系统”

Cursor 被很多人当成“带AI的VS Code”，这是最大的误解。VS Code 是一个“编辑器”，它的核心是文本处理；Cursor 是一个“开发操作系统”，它的核心是意图理解与工作流编排。最直观的区别在右键菜单：VS Code 的右键是“复制”“粘贴”“查找”；Cursor 的右键是“解释这段代码的业务逻辑”“生成这个函数的单元测试”“把这个错误日志关联到Sentry Issue”“用中文重写这个commit message”。

它的底层架构有三个颠覆性设计：

1. 双渲染引擎：Cursor 同时运行一个VS Code兼容的Monaco编辑器内核（处理光标、语法高亮、基础补全），和一个独立的AI推理前端（基于WebAssembly编译的轻量级LLM runtime）。这意味着即使网络断开，你依然能用本地模型（如LM Studio加载的Phi-3）执行“重写注释”“简化条件表达式”这类低延迟任务；而当需要复杂推理（如“重构整个模块以支持微前端”）时，它才无缝切换到云端Claude。
2. 意图路由层（Intent Router）：当你在编辑器里输入// TODO: 优化这个循环性能并按下Ctrl+Enter，Cursor 不是简单地把这句话发给AI，而是先经过Intent Router分析：
   • TODO标签 → 触发“代码优化”意图
   • “循环性能”关键词 → 匹配到performance-optimization规则集
   • 当前文件是src/utils/array-processor.ts→ 加载array-processor专用提示词模板
   • 检测到for (let i = 0; i < arr.length; i++)→ 自动识别为经典性能陷阱，优先建议缓存arr.length这个路由层让Cursor能对同一句话（比如“让它更好”）在不同上下文中给出截然不同的响应。
3. 工作区即应用（Workspace-as-App）：在Cursor里，一个工作区（workspace）不是一个文件夹，而是一个可安装、可更新、可分享的“应用”。你可以从Cursor Market下载一个“Next.js SEO Optimizer”工作区，它会自动：
   • 安装next-seo包
   • 在next.config.js里注入SEO相关配置
   • 创建/app/[lang]/layout.tsx的模板文件
   • 配置Codex CLI的seo-audit命令
   • 设置Claude Code的SEO规则（如“所有页面必须有<title>和<meta name='description'>”）

这彻底改变了“配置开发环境”的范式——你不再需要看几十页文档去手动配置，而是像安装手机APP一样，一键获得一个预装了所有最佳实践的、开箱即用的开发环境。我团队现在的新项目启动流程，已经从“新人花两天配环境”变成了“新人下载Cursor，导入项目，点一下‘Install Workspace App’，喝杯咖啡回来，环境就ready了”。

3. 实操部署：从零搭建属于你的Superpowers工作流

3.1 环境准备与基础依赖安装

开始之前，请务必确认你的系统满足最低要求：macOS 13+/Windows 10 22H2+/Ubuntu 22.04 LTS，且已安装Node.js 18.17+和Python 3.9+。不要用nvm或pyenv管理的版本，Superpowers工具链对运行时环境的ABI兼容性要求极高，我亲眼见过用nvm切换Node版本导致Codex CLI的二进制插件（如codex-cli-remotion）直接段错误。最稳妥的方式是直接从官网下载LTS安装包，让系统PATH指向它。

第一步，安装Cursor。这不是简单的下载dmg/exe。你需要访问 cursor.sh （注意是.sh，不是.com），下载最新版。安装完成后，不要急着打开。先打开终端，执行：

# 创建Superpowers专用目录，避免污染全局环境 mkdir -p ~/superpowers/{tools,workspaces,configs} # 下载并安装Cursor的CLI工具（用于自动化配置） curl -fsSL https://raw.githubusercontent.com/getcursor/cursor-cli/main/install.sh | sh # 将Cursor CLI加入PATH echo 'export PATH="$HOME/.cursor/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

提示：cursor-cli是Cursor官方提供的命令行工具，它能让你用cursor config set命令批量修改设置，比手动点菜单快十倍。很多教程漏掉这一步，导致后续配置全是手动操作，极其痛苦。

第二步，安装Claude Code。这里有个关键细节：Claude Code 不是独立应用，而是Cursor的一个扩展。所以你必须先在Cursor里启用它。打开Cursor，按Cmd/Ctrl+Shift+P打开命令面板，输入Extensions: Install Extensions，搜索Claude Code，点击安装。安装完成后，不要重启Cursor，而是立即按Cmd/Ctrl+,打开设置，搜索claude，找到Claude Code: Api Key，点击Edit in settings.json。在这里，你不能直接粘贴API Key，因为Superpowers要求密钥管理由Antigravity统一处理。你需要改成：

{ "claudeCode.apiKey": "${ANTIGRAVITY_API_KEY}", "claudeCode.model": "claude-3-sonnet-20240229" }

这个${ANTIGRAVITY_API_KEY}是一个环境变量占位符，它会在Antigravity启动时被自动注入。现在，你只是完成了“声明”，真正的密钥获取还在后面。

第三步，安装Antigravity。官方没有提供一键安装脚本，因为它的核心是trustchain.yaml的声明式配置。你需要手动创建：

# 进入Superpowers目录 cd ~/superpowers # 初始化Antigravity配置 cursor-cli init antigravity --template minimal # 这会生成一个基础的trustchain.yaml cat trustchain.yaml

你会看到一个精简版的配置，里面只有providers和validations的骨架。现在，你需要填充它。假设你的项目用AWS，那么编辑trustchain.yaml：

providers: - name: "aws-dev" type: "aws-iam-role" role_arn: "arn:aws:iam::YOUR-ACCOUNT-ID:role/superpowers-dev" region: "us-west-2" # 关键：添加SSO配置，让Antigravity能自动登录 sso_start_url: "https://your-company.awsapps.com/start" sso_region: "us-east-1" sso_account_id: "YOUR-ACCOUNT-ID" sso_role_name: "superpowers-dev" validations: - name: "node-version" command: "node --version" expected: "^v18.17" - name: "docker-running" command: "docker info --format '{{.ID}}'" expected: ".+"

注意：sso_start_url必须是你公司AWS SSO的准确URL，不能是https://portal.aws.amazon.com。我踩过的最大坑就是这里填错了，导致Antigravity一直卡在“Waiting for SSO login...”，实际是URL 404了。你可以用浏览器访问这个URL，确认能正常跳转到SSO登录页。

第四步，安装Codex CLI。官方推荐用npm，但为了版本锁定，我强烈建议用corepack（Node.js 16.13+内置）：

# 启用corepack corepack enable # 安装Codex CLI为项目级依赖（不是全局） cd ~/superpowers npm init -y npm install --save-dev codex-cli # 创建一个快捷脚本，避免每次都要npx echo '#!/bin/bash\nnpx codex-cli "$@"' > ~/superpowers/tools/codex chmod +x ~/superpowers/tools/codex echo 'export PATH="$HOME/superpowers/tools:$PATH"' >> ~/.zshrc source ~/.zshrc

现在，你在任何目录下都能直接运行codex --help。但此时它还不能用，因为缺少模型配置。Codex CLI 默认不绑定任何大模型，它需要你显式指定。编辑~/superpowers/package.json，在scripts里添加：

"scripts": { "codex:setup": "codex config set model claude-3-sonnet-20240229", "codex:audit": "codex audit security --rule owasp-top10" }

然后运行npm run codex:setup。这会在~/superpowers/node_modules/codex-cli/config.json里写入模型配置。记住，这个配置是项目级的，不同项目可以用不同模型，互不干扰。

3.2 核心工作流配置：让四大组件真正“联动”起来

光装好工具还不够，Superpowers的威力在于它们之间的“化学反应”。最关键的联动点有三个：环境变量注入、意图路由打通、工作流自动化。

首先是环境变量注入。这是Antigravity和Claude Code/Codex CLI协作的基础。你需要让Antigravity在验证通过后，把密钥和配置注入到当前shell，同时让Cursor能感知到。编辑~/superpowers/trustchain.yaml，在providers下面添加一个envprovider：

providers: # ... 之前的aws-dev配置保持不变 - name: "claude-api-key" type: "env" value: "sk-ant-some-long-string-from-your-claude-console" # 关键：设置为敏感变量，Antigravity会加密存储 sensitive: true - name: "codex-model" type: "env" value: "claude-3-sonnet-20240229" # 这个不敏感，可以明文 sensitive: false

然后，在~/superpowers/.cursor/settings.json里，确保有：

{ "terminal.integrated.env.osx": { "ANTIGRAVITY_API_KEY": "${ANTIGRAVITY_API_KEY}", "CODEX_MODEL": "${CODEX_MODEL}" }, "terminal.integrated.env.linux": { ... }, "terminal.integrated.env.windows": { ... } }

这样，当你在Cursor的集成终端里运行codex audit，它就能读取到$CODEX_MODEL环境变量，自动使用Claude Sonnet模型；而Claude Code在编辑器里也会读取$ANTIGRAVITY_API_KEY，无需手动配置。

第二个联动点是指令路由。Cursor的右键菜单默认只有一堆通用选项。你要把它变成“项目专属”。在~/superpowers目录下，创建.cursor/intent-rules.json：

{ "rules": [ { "trigger": "generate api docs", "action": "codex generate api-docs --format openapi3 --output ./docs/api-spec.yml", "description": "基于当前项目路由和类型定义，生成OpenAPI 3.0规范文档" }, { "trigger": "fix security issue", "action": "codex audit security --rule owasp-top10 --fix", "description": "扫描OWASP Top 10漏洞并自动修复可修复项" } ] }

然后在Cursor设置里，搜索intent rules，把Path to Intent Rules File指向~/superpowers/.cursor/intent-rules.json。重启Cursor，现在右键菜单里就会出现“Generate API Docs”和“Fix Security Issue”这两个选项。点一下，它就自动执行对应的Codex CLI命令。

第三个联动点是工作流自动化。这才是Superpowers的终极形态——把一连串手动操作变成一个原子命令。创建~/superpowers/workflows/deploy-to-staging.sh：

#!/bin/bash # 这是一个完整的部署工作流 echo "🚀 开始部署到Staging环境..." # 步骤1：用Antigravity验证所有依赖 echo "✅ 步骤1：验证环境..." antigravity apply --profile staging || { echo "❌ 环境验证失败"; exit 1; } # 步骤2：用Codex CLI生成本次部署的Changelog echo "✅ 步骤2：生成Changelog..." codex generate changelog --since $(git describe --tags --abbrev=0) --output ./CHANGELOG-staging.md # 步骤3：用Claude Code检查本次变更的潜在风险 echo "✅ 步骤3：AI风险扫描..." cursor-cli run ai-scan --diff --severity high # 步骤4：执行实际部署（这里调用你的CI脚本） echo "✅ 步骤4：执行部署..." npm run deploy:staging echo "🎉 部署完成！Changelog已生成：./CHANGELOG-staging.md"

赋予执行权限：chmod +x ~/superpowers/workflows/deploy-to-staging.sh。现在，无论你是新手还是老手，只要运行这个脚本，就能完成一次标准化、可审计、带AI护航的部署。整个过程不需要你记住任何命令，也不需要你理解每个步骤的原理——你只需要知道“这个脚本能安全地把代码送到Staging”。

3.3 高级定制：本地模型接入与多语言支持实战

Superpowers的灵活性，体现在它不绑定任何特定厂商。你可以轻松把Claude Code换成本地运行的Qwen2.5，把Codex CLI的默认模型换成LM Studio里的Phi-3，甚至让Cursor的中文回复变成默认行为。这需要三步配置。

第一步：配置LM Studio作为本地模型服务。下载LM Studio，启动后，从Hugging Face Hub下载Qwen/Qwen2.5-0.5B-Instruct模型（小而快，适合本地）。在LM Studio的Settings→Local Server里，开启Enable Local Server，端口设为1234，模型选中你下载的Qwen2.5。启动服务器，你会看到一个绿色的“Running”指示灯。

第二步：让Codex CLI指向这个本地模型。编辑~/superpowers/node_modules/codex-cli/config.json，把model字段改成：

{ "model": "http://localhost:1234/v1/chat/completions", "api_key": "lm-studio", // LM Studio不需要key，但Codex CLI要求非空 "provider": "openai-compatible" }

现在，所有codex命令都会调用你的本地Qwen2.5。实测下来，生成单元测试、重写注释这类任务，Qwen2.5的响应速度比云端Claude快3倍，且100%离线，隐私无忧。

第三步：让Cursor默认用中文回复。很多人搜“cursor中文怎么设置”，其实很简单，但官方文档藏得太深。在Cursor里，按Cmd/Ctrl+Shift+P，输入Preferences: Open Settings (JSON)，在打开的settings.json里添加：

{ "claudeCode.language": "zh-CN", "editor.quickSuggestions": { "strings": true, "comments": true, "other": true }, "editor.suggest.snippetsPreventQuickSuggestions": false, // 关键：覆盖所有AI交互的默认语言 "cursor.ai.defaultLanguage": "zh-CN" }

重启Cursor，现在所有AI生成的内容（代码补全、解释、重写）都是中文。但要注意一个细节：cursor.ai.defaultLanguage只影响AI输出，不影响Cursor自身的UI语言。如果你想让菜单、设置页也变中文，需要在系统层面设置。macOS：System Settings→Language & Region→ 把中文拖到最顶部；Windows：Settings→Time & Language→Language→Windows display language→ 选中文。Ubuntu稍微麻烦点，需要在终端运行：

sudo update-locale LANG=zh_CN.UTF-8 # 然后重启Cursor

实操心得：我最初以为改cursor.ai.defaultLanguage就够了，结果发现右键菜单的“Explain Code”还是英文。后来才发现，Cursor的右键菜单语言是跟随系统语言的，而AI输出语言才是defaultLanguage控制的。所以必须双管齐下。另外，中文模型对代码标识符（如变量名userProfileData）的理解不如英文模型，建议在.cursor/intent-rules.json里，对中文触发词做映射，比如：

{ "trigger": "解释代码", "action": "codex explain --language en", "description": "用英文解释代码（中文模型对代码术语理解更准）" }

4. 常见问题与排查技巧实录：那些官方文档不会写的坑

4.1 “Your organization has disabled Claude subscription access” 错误的根源与解法

这个报错是Superpowers新手遇到的最高频问题，但它根本不是Cursor或Claude Code的问题，而是你的企业SSO策略与Antigravity的权限模型冲突。根本原因在于：Antigravity在尝试为你获取Claude API Key时，会模拟一个“组织级应用”的身份去调用Claude的OAuth2端点。而很多公司的IT策略，会禁用所有第三方应用的OAuth访问权限，尤其是对claude.ai域名的访问。

排查步骤：

1. 确认是否真的是组织策略问题：在浏览器里访问https://claude.ai，用你的公司邮箱登录。如果直接跳转到“Your organization has disabled access”，那就100%是IT策略问题。
2. 绕过组织策略的临时方案：Antigravity支持“手动密钥注入”。编辑~/superpowers/trustchain.yaml，在providers里添加：

   - name: "claude-api-key-manual" type: "env" value: "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # 从claude.ai的Settings里复制 sensitive: true # 关键：添加这个标记，告诉Antigravity不要尝试自动获取 manual_only: true

3. 永久解决方案（需IT部门配合）：联系IT，要求他们为claude.ai添加白名单，并授权Antigravity OAuth Client ID（这个ID可以在Antigravity的GitHub仓库的docs/enterprise-setup.md里找到）。这不是加一个域名那么简单，需要IT在Azure AD或Okta里创建一个企业应用，并分配User.Read和Directory.Read.All权限。

注意：网上很多教程让你“用个人邮箱注册Claude”，这是饮鸩止渴。个人账号的免费额度极低（每天5次），且无法与企业SSO集成，一旦你离职，所有配置就失效了。Superpowers的设计哲学是“企业级可维护”，所以必须走组织授权路线。

4.2 Codex CLI 的/compact命令失效：路径与上下文陷阱

codex compact是个神器，但极易失效。最常见的原因是路径硬编码。比如你在一个项目里写了：

codex compact --name build-docker --steps "cd ./backend && docker build -t myapp-backend ."

这个命令在/Users/you/project下能用，但一旦你把它分享给同事，同事在/home/user/my-project下运行，cd ./backend就会失败，因为路径不对。

正确做法是使用Codex CLI的项目相对路径解析。所有compact命令的步骤，都应该以$PROJECT_ROOT开头：

codex compact --name build-docker --steps "cd \$PROJECT_ROOT/backend && docker build -t myapp-backend ."

注意$PROJECT_ROOT要用反斜杠转义，否则shell会提前展开。Codex CLI在执行时，会自动把$PROJECT_ROOT替换成当前工作目录的绝对路径。

另一个坑是环境变量丢失。compact命令默认在干净的shell环境中执行，不会继承你当前终端的PATH或自定义变量。如果你的步骤里用了nvm管理的Node版本，必须显式指定：

codex compact --name test-with-node18 --steps "nvm use 18 && npm test"

或者更稳妥地，用绝对路径：

codex compact --name test-with-node18 --steps "/Users/you/.nvm/versions/node/v18.17.0/bin/node node_modules/.bin/jest"

4.3 Cursor 中文设置后，代码补全变差：模型与语言的错配

当你把cursor.ai.defaultLanguage设为zh-CN后，会发现代码补全的准确率明显下降，尤其是对TypeScript接口、React Hook名称的预测。这不是Bug，而是语言模型的固有局限：当前所有开源的中文大模型（包括Qwen、GLM），其训练语料中，代码标识符（如useState,useEffect,interface User）几乎全是英文。模型学会了“中文描述”和“英文代码”的映射，但没学会“中文描述”和“中文代码”的映射——因为根本不存在“中文代码”。

解决方案有两个：

1. 分场景设置语言：在.cursor/settings.json里，用"[typescript]"和"[javascript]"的language-specific设置，只对注释和解释用中文，对代码生成保持英文：

   "[typescript]": { "claudeCode.language": "en-US", "editor.suggest.showSnippets": true }, "[markdown]": { "claudeCode.language": "zh-CN", "editor.suggest.showSnippets": false }

2. **用提示词强制模型输出英文