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.yamlproviders: - 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它会检查你本地是否拥有aws-production角色的临时凭证通过AWS SSO或aws configure sso如果没有自动打开SSO登录页完成MFA后获取凭证验证slack-webhookURL是否可访问发送一个测试消息到#alerts-dev执行redis-cli PING和prisma migrate status确认所有依赖服务就绪将验证通过的环境变量如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.ymlcodex refactor legacy-code --pattern react-class-component --target react-hookscodex audit security --rule owasp-top10 --output ./reports/security-audit.md这些命令背后是Codex CLI 对你项目的一次深度“体检”。当你运行codex generate api-docs它会解析所有src/routes/**/*.{ts,js}文件提取Express/Koa/Hono的路由定义扫描src/middlewares/auth.ts等文件识别认证方式JWT、Session、API Key分析src/types/index.ts提取请求/响应体的TypeScript接口结合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 storybooklatest init # 步骤3配置ESLint规则 cp ./templates/eslint-config-react.js .eslintrc.js你可以运行codex compact --name create-storybook-component --steps npx create-react-app..., npx storybooklatest 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”。它的底层架构有三个颠覆性设计双渲染引擎Cursor 同时运行一个VS Code兼容的Monaco编辑器内核处理光标、语法高亮、基础补全和一个独立的AI推理前端基于WebAssembly编译的轻量级LLM runtime。这意味着即使网络断开你依然能用本地模型如LM Studio加载的Phi-3执行“重写注释”“简化条件表达式”这类低延迟任务而当需要复杂推理如“重构整个模块以支持微前端”时它才无缝切换到云端Claude。意图路由层Intent Router当你在编辑器里输入// TODO: 优化这个循环性能并按下CtrlEnterCursor 不是简单地把这句话发给AI而是先经过Intent Router分析TODO标签 → 触发“代码优化”意图“循环性能”关键词 → 匹配到performance-optimization规则集当前文件是src/utils/array-processor.ts→ 加载array-processor专用提示词模板检测到for (let i 0; i arr.length; i)→ 自动识别为经典性能陷阱优先建议缓存arr.length这个路由层让Cursor能对同一句话比如“让它更好”在不同上下文中给出截然不同的响应。工作区即应用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 namedescription”这彻底改变了“配置开发环境”的范式——你不再需要看几十页文档去手动配置而是像安装手机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/CtrlShiftP打开命令面板输入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.yamlproviders: - 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但为了版本锁定我强烈建议用corepackNode.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下面添加一个envproviderproviders: # ... 之前的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 --abbrev0) --output ./CHANGELOG-staging.md # 步骤3用Claude Code检查本次变更的潜在风险 echo ✅ 步骤3AI风险扫描... 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/CtrlShiftP输入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语言。如果你想让菜单、设置页也变中文需要在系统层面设置。macOSSystem Settings→Language Region→ 把中文拖到最顶部WindowsSettings→Time Language→Language→Windows display language→ 选中文。Ubuntu稍微麻烦点需要在终端运行sudo update-locale LANGzh_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域名的访问。排查步骤确认是否真的是组织策略问题在浏览器里访问https://claude.ai用你的公司邮箱登录。如果直接跳转到“Your organization has disabled access”那就100%是IT策略问题。绕过组织策略的临时方案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永久解决方案需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/jest4.3 Cursor 中文设置后代码补全变差模型与语言的错配当你把cursor.ai.defaultLanguage设为zh-CN后会发现代码补全的准确率明显下降尤其是对TypeScript接口、React Hook名称的预测。这不是Bug而是语言模型的固有局限当前所有开源的中文大模型包括Qwen、GLM其训练语料中代码标识符如useState,useEffect,interface User几乎全是英文。模型学会了“中文描述”和“英文代码”的映射但没学会“中文描述”和“中文代码”的映射——因为根本不存在“中文代码”。解决方案有两个分场景设置语言在.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 }**用提示词强制模型输出英文