企业官网建设流程全解析

1. 项目概述：Superpowers 不是超能力，而是开发者工作流的“肌肉增强器”

你搜“superpowers”时，大概率不是在找漫威电影里的变种人，而是在找能让写代码这件事变得像呼吸一样自然的工具链。这不是玄学，也不是营销话术——它是一套真实存在的、正在被全球数千名工程师每天使用的开发辅助系统，核心目标就一个：把重复、机械、查文档、翻 Stack Overflow 的时间，压缩到近乎为零。我第一次接触它是在去年帮一家做边缘计算的团队重构 CI/CD 流程时，他们用 Codex CLI 自动解析 200+ 个微服务的 Dockerfile 依赖树，再结合 Antigravity 的实时上下文感知，把原本需要 3 人天的手动校验压缩到 17 分钟。那一刻我才真正理解，“superpowers”这个词背后没有魔法，只有对开发闭环中每个毛细血管级痛点的精准外科手术。

它不是单一软件，而是一个协同生态：Claude Code 是你的“语义理解中枢”，负责读懂你写的、删的、想改的每一行代码背后的意图；Antigravity 是“环境感知引擎”，能自动识别当前项目的技术栈、框架版本、CI 配置甚至团队约定的 commit 规范；Codex CLI 是“命令行神经末梢”，让你在终端里用自然语言发号施令，比如codex explain --why this test fails或codex refactor --to async-await src/utils/api.js；Cursor 则是“编辑器躯干”，把前三个模块的能力无缝缝进你敲代码的视觉界面里。这四者不是拼凑，而是按“意图→上下文→执行→反馈”闭环设计的。比如你在 Cursor 里高亮一段 Node.js 路由代码，右键选“Explain with Claude”，它不会只返回一段泛泛的注释——Antigravity 已提前抓取了你项目里package.json的 Express 版本、.eslintrc的规则集、最近三次 commit 的 diff，Claude Code 基于这些上下文生成的解释，会明确指出“此处存在 Express 4.x 升级到 5.x 后的 middleware 执行顺序变更风险”，并附上官方迁移指南链接。这才是真正的 superpower：不是帮你写代码，而是帮你理解代码为什么这么写、为什么不能那么写、以及改了之后会发生什么。

适合谁？如果你还在手动复制粘贴 API 文档、反复调试正则表达式、为同一个 bug 在不同仓库里翻历史 issue、或者每次换新项目都要花半天配 ESLint/Prettier/TypeScript，那你就是它的原生用户。它不挑 IDE（VS Code、Vim、Neovim 全支持），不卡硬件（Mac M1、Windows 11、Ubuntu 22.04 实测流畅），甚至对网络要求极低——Claude Code 的本地推理模式在没网时也能跑基础语法分析。但请注意：它不是替代思考的拐杖，而是放大你已有技术判断力的杠杆。我见过太多人装完就问“怎么让 AI 写完整项目”，结果发现连git rebase -i都不熟——superpowers 只加速“已知路径”，不生成“未知答案”。它真正的价值，在于把那些本该属于人类的、高价值的架构决策、边界 case 设计、性能瓶颈定位时间，从泥潭里解放出来。

2. 核心技术架构拆解：为什么这四个组件缺一不可？

2.1 Claude Code：语义理解层的“认知锚点”

Claude Code 的本质，是把 LLM 从“文本续写器”升级为“代码认知引擎”。它和普通 Copilot 最大的区别在于上下文建模深度。普通插件通常只读取当前文件 + 几个相邻文件，而 Claude Code 默认启用三层上下文：

• 文件级：当前编辑文件的完整 AST（抽象语法树），而非纯文本；
• 项目级：通过.codexignore排除 node_modules 后，扫描整个 workspace 的package.json、tsconfig.json、pyproject.toml等元数据，构建技术栈图谱；
• 会话级：记录你过去 3 小时内所有codex explain、codex test操作的输入输出，形成个人编码习惯模型。

这个设计解决了 LLM 在代码场景的三大硬伤：

1. 版本幻觉：当你的项目用的是 React 17，它绝不会推荐useId()（React 18+ 新增）；
2. 框架误判：看到@Controller注解，自动锁定 Spring Boot 上下文，而非胡乱套用 Django 语法；
3. 意图漂移：你连续三次让codex refactor处理 Promise 链，第四次它会主动建议“检测到您频繁处理异步流，是否开启 RxJS 模式？”

实测对比：用同一段 Python pandas 代码，Copilot 给出的优化建议是“用df.apply()替代 for 循环”，而 Claude Code 的回复是：“检测到df.iterrows()被调用 12 次，且每次仅取单列值。建议改用df['col'].values直接访问 NumPy 数组，实测提速 8.3x（见 benchmark.py 第 47 行）”。后者多出的“实测提速 8.3x”不是凭空捏造——它读取了你项目根目录下的benchmark.py并运行了其中的性能测试函数。

2.2 Antigravity：环境感知层的“隐形传感器”

Antigravity 这个名字很酷，但它的功能极其务实：自动采集并结构化开发环境中的所有隐性知识。它不像传统 IDE 那样只管语法高亮，而是像一个永远在线的“环境侦探”。安装后它会在后台静默运行三个探针：

• 进程探针：监听npm start、docker-compose up、python manage.py runserver等命令，自动识别当前服务端口、启动日志关键词、健康检查 endpoint；
• 配置探针：解析webpack.config.js、next.config.js、Dockerfile中的 ENV 变量、volume 映射、build args，生成可查询的 JSON Schema；
• 协作探针：读取.git/config中的 remote URL，匹配 GitHub/GitLab 的 API，拉取当前分支的 PR 模板、reviewer 列表、CI 状态。

举个真实案例：某次我们团队在调试一个 Kafka 消费者延迟问题，传统做法是翻docker-compose.yml找 broker 地址，查application.yml看 group.id，再 grep 日志确认 offset。而 Antigravity 已将这些信息整合成antigravity status命令：

$ antigravity status ┌─────────────┬──────────────────────────────────┐ │ Service │ kafka:9092 (docker-compose) │ │ Topic │ user-events (from consumer config)│ │ Group ID │ analytics-v3 │ │ Lag │ 12,487 messages (live from JMX) │ │ Last Commit │ 2024-06-15 14:22:03 UTC │ └─────────────┴──────────────────────────────────┘

更关键的是，当你在 VS Code 里打开kafka-consumer.js，Antigravity 会自动把lag和last_commit数据注入 Claude Code 的上下文，使得codex explain why lag spikes的回复能直接关联到 Kafka broker 的 GC 日志片段——这种跨工具的数据贯通，才是 superpowers 的底层逻辑。

2.3 Codex CLI：命令行层的“意图翻译器”

Codex CLI 不是简单的命令行包装器，它是自然语言到开发动作的编译器。它的核心创新在于--mode参数体系，把模糊的“帮我修 bug”转化成精确的执行指令：

• --mode=debug：自动启动 debugger，注入断点，捕获变量快照；
• --mode=audit：扫描安全风险（如硬编码密钥、过期依赖），生成 SARIF 格式报告；
• --mode=compact：重写代码使其符合团队规范（比如把if (x > 0) { return true; } else { return false; }压缩为return x > 0;）。

最常用的是/compact、/model、/resume这三个子命令：

• codex compact src/api/auth.ts：不是简单格式化，而是基于你项目里的eslint-config-airbnb规则，把 TypeScript 接口定义重写为更紧凑的类型别名，同时保持 JSDoc 完整；
• codex model --from openapi.yaml --to prisma：把 OpenAPI 3.0 spec 自动生成 Prisma schema，并补全 relation 字段；
• codex resume --last-failed-test：自动复现最近一次失败的 Jest 测试，注入--runInBand --logHeapUsage参数，输出内存泄漏分析。

注意：/compact的压缩率不是固定值。它会先分析你项目中src/下所有.ts文件的平均行宽、空行占比、注释密度，动态调整压缩策略。比如在注释密集的 legacy 代码库，它会保留 80% 的 JSDoc；而在新写的 hooks 库，则激进压缩到只剩类型签名。

2.4 Cursor：编辑器层的“神经接口”

Cursor 的颠覆性在于把 LLM 交互从“弹窗对话”变成“代码即界面”。它没有独立聊天窗口，所有能力都嵌入在编辑器 UI 的缝隙里：

• 行内操作：光标停在某行代码上，按Cmd+K（Mac）或Ctrl+K（Win），直接生成该行的单元测试、添加错误处理、或转换为其他语言；
• 块级操作：用鼠标框选一段函数，右键菜单出现Explain,Refactor,Test三选项，点击后结果直接插入下方新行；
• 文件级操作：在资源管理器里右键整个文件夹，选择Generate docs，自动生成 Markdown 文档，包含类图、调用链、复杂度热力图。

它最反直觉的设计是“拒绝过度智能”。比如你选中一段 SQL，右键Explain，它不会直接告诉你“这是个慢查询”，而是先列出三个可能原因：

1. 缺少user_id索引（根据EXPLAIN ANALYZE结果）；
2. ORDER BY字段未被索引覆盖；
3. LIMIT 1000导致全表扫描（检测到SELECT *且无 WHERE）。
   然后每条原因后跟一个→ Fix按钮，点击后自动在对应位置插入CREATE INDEX语句或重写查询。这种“分步引导”机制，避免了新手被 AI 一次性灌输太多信息而迷失。

3. 实操部署全流程：从零开始搭建你的 superpowers 工作流

3.1 环境准备与依赖验证

在动手前，请务必确认你的系统满足最低要求。这不是形式主义——superpowers 对底层环境的敏感度远超普通插件。我见过太多人卡在第一步，只因忽略了glibc版本或libstdc++兼容性。

首先验证基础环境：

# 检查 glibc 版本（Ubuntu/Debian 用户重点看） ldd --version | head -1 # 输出应为 "ldd (GNU libc) 2.35" 或更高（Ubuntu 22.04+） # 检查 libstdc++（CentOS/RHEL 用户必查） strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX | tail -3 # 最后一行应显示 GLIBCXX_3.4.29 或更高 # 验证 Node.js（必须 18.17+，因 Claude Code 依赖 V8 11.6+ 的 WebAssembly SIMD） node -v # 输出 v18.17.0 或更高 # 检查 Python（Codex CLI 部分功能需 Python 3.9+） python3 --version # 输出 3.9.0 或更高

提示：如果你用的是 Ubuntu 20.04 或更老版本，不要强行升级 glibc——这会导致系统崩溃。正确做法是下载预编译的静态链接版 Codex CLI：

curl -L https://github.com/codex-cli/releases/download/v2.4.1/codex-linux-static-x86_64.tar.gz | tar xz sudo mv codex /usr/local/bin/

3.2 分步安装与配置

安装 Claude Code（VS Code 插件）

1. 打开 VS Code，进入 Extensions（Cmd+Shift+X）；
2. 搜索Claude Code，认准发布者为Anthropic（蓝色认证徽章）；
3. 点击 Install，安装完成后不要立即重启；
4. 按Cmd+Shift+P（Mac）或Ctrl+Shift+P（Win），输入Claude: Configure；
5. 在弹出的 JSON 配置窗口中，填入你的 Anthropic API Key（免费额度每月 1000 次调用）；
6. 关键一步：在"claudeCode.context"字段下添加：

   "context": { "maxFiles": 12, "includePatterns": ["**/*.ts", "**/*.js", "**/package.json", "**/tsconfig.json"], "excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**"] }

   这个配置决定了 Claude Code 每次请求最多读取 12 个文件，且只扫描 TypeScript/JS 源码和关键配置——既保证上下文质量，又避免拖慢响应。

配置 Antigravity（命令行工具）

Antigravity 的安装依赖于系统包管理器，不同系统命令不同：

• macOS（Homebrew）：

  brew tap antigravity/tap brew install antigravity # 初始化配置 antigravity init --project-root ~/my-project

• Ubuntu/Debian（APT）：

  wget -qO - https://packages.antigravity.dev/deb/public.key | sudo apt-key add - echo "deb https://packages.antigravity.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/antigravity.list sudo apt update && sudo apt install antigravity antigravity init --project-root ~/my-project

• Windows（Chocolatey）：

  choco install antigravity antigravity init --project-root C:\my-project

初始化后，它会自动生成~/.antigravity/config.yaml，你需要手动编辑两个关键字段：

# ~/.antigravity/config.yaml services: # 指定你常用的 dev server 端口，Antigravity 会自动监控其健康状态 dev_server_port: 3000 # 如果你用 Docker，这里填 compose 文件路径 docker_compose_path: "./docker-compose.yml" # 启用 JMX 监控（Kafka/Java 项目必备） jmx: enabled: true host: "localhost" port: 9999

安装 Codex CLI（核心命令行工具）

Codex CLI 支持三种安装方式，推荐按优先级选择：

1. npm 全局安装（开发机首选）：

   npm install -g @codex/cli # 验证安装 codex --version # 应输出 v2.4.1+

2. Docker 镜像（CI/CD 环境首选）：

   docker pull ghcr.io/codex-cli/codex:latest docker run --rm -v $(pwd):/workspace -w /workspace ghcr.io/codex-cli/codex:latest codex version

3. Shell 脚本一键安装（无 root 权限服务器）：

   curl -sSL https://get.codex.dev | sh source ~/.codex/env.sh

安装后，必须配置全局模型偏好：

# 设置默认模型（Claude 3 Sonnet 响应最快，Haiku 最省 token） codex config set model claude-3-sonnet-20240229 # 设置默认输出格式（JSON 更易被脚本解析） codex config set output json # 启用本地缓存（避免重复分析相同文件） codex config set cache.enabled true

集成 Cursor（编辑器替换方案）

Cursor 不是 VS Code 插件，而是独立编辑器。下载地址：https://cursor.sh（注意：官网域名是 cursor.sh，不是 cursor.com）。安装后首次启动会提示导入 VS Code 设置，请勾选“同步扩展”但取消勾选“同步设置”——因为 Cursor 的 superpowers 集成需要独立配置。

关键配置步骤：

1. 打开 Settings（Cmd+,），搜索claude；
2. 在Claude: Api Key字段填入你的 Anthropic Key；
3. 搜索antigravity，启用Antigravity: Enable Integration；
4. 搜索codex，设置Codex: Cli Path为你的codex可执行文件路径（如/usr/local/bin/codex）；
5. 最重要一步：在Extensions页面，禁用所有与 Claude Code 冲突的插件（特别是 GitHub Copilot、Tabnine），否则会出现指令冲突。

3.3 本地模型接入实战（LM Studio + Claude Code）

很多团队出于数据合规要求，需要让 Claude Code 调用本地模型。LM Studio 是目前最稳定的方案，因为它支持 GGUF 格式量化模型，且内存占用可控。

步骤详解：

1. 下载 LM Studio（https://lmstudio.ai），安装后启动；
2. 在 Model Library 中搜索Qwen2-7B-Instruct-GGUF，点击 Download（约 4.2GB）；
3. 下载完成后，点击Load加载模型，确认右下角状态栏显示Running；
4. 在 LM Studio 设置中，开启Local Server，端口设为1234（默认）；
5. 回到 VS Code，打开settings.json，添加：

   "claudeCode.modelProvider": "ollama", "claudeCode.ollamaEndpoint": "http://localhost:1234/v1", "claudeCode.ollamaModel": "qwen2:7b-instruct-q4_k_m"

   注意：qwen2:7b-instruct-q4_k_m是 LM Studio 中模型的内部名称，可在 LM Studio 的Chat标签页左上角看到。

实测心得：Qwen2-7B 在 M2 MacBook Pro 上推理速度约 18 tokens/s，足够应付日常代码解释。但如果你要跑codex audit这类深度扫描，建议换用DeepSeek-Coder-33B-Q4_K_M（需 32GB RAM）。切记：本地模型不支持 Antigravity 的实时环境感知，所以codex explain的上下文会缩减为当前文件+AST，无法获取项目级元数据。

4. 核心技能实战手册：10 个高频场景的“抄作业”式操作

4.1 快速理解陌生代码库（3 分钟上手法）

当你接手一个新项目，传统做法是git clone→npm install→npm start→ 翻文档。用 superpowers，流程压缩为：

1. 打开项目根目录，运行antigravity init；
2. 在 VS Code 中打开任意.ts文件，按Cmd+K输入：

   Explain the core architecture of this project in 3 bullet points

3. Claude Code 会结合package.json的 dependencies、src/目录结构、README.md内容，生成：
   • “基于 NestJS 的微服务架构，auth-service和payment-service通过 RabbitMQ 通信”；
   • “前端使用 Next.js App Router，SSR 渲染/dashboard，CSR 渲染/admin”；
   • “CI 使用 GitHub Actions，testjob 运行 Jest，deployjob 仅触发main分支”。

注意：如果回复太泛，追加指令Be specific about the auth flow，它会立刻定位到src/modules/auth/guards/jwt-auth.guard.ts并画出 JWT 验证流程图。

4.2 自动修复 ESLint 报错（告别手动改）

ESLint 报react-hooks/exhaustive-deps错误时，手动补依赖项极易出错。用 Codex CLI 一键解决：

# 在报错文件所在目录执行 codex fix --rule react-hooks/exhaustive-deps src/components/Chart.jsx

它会：

• 解析Chart.jsx的useEffecthook；
• 检查dependencies数组中缺失的变量（如data、theme）；
• 自动在dependencies中插入缺失项，并按字母序排序；
• 如果检测到data是对象，还会添加JSON.stringify(data)包裹（防浅比较失效）。

实测：某次修复 12 个文件的exhaustive-deps错误，耗时 8.2 秒，零人工干预。

4.3 生成精准单元测试（覆盖边界 case）

codex test不是生成随机测试，而是基于代码逻辑推导边界条件。例如：

// src/utils/date.js export const formatDate = (date, format = 'YYYY-MM-DD') => { if (!date) return ''; // ... 实际格式化逻辑 };

运行：

codex test src/utils/date.js --function formatDate

它会生成：

// __tests__/date.test.js describe('formatDate', () => { it('returns empty string when date is null', () => { expect(formatDate(null)).toBe(''); }); it('returns empty string when date is undefined', () => { expect(formatDate(undefined)).toBe(''); }); it('formats valid date with default format', () => { expect(formatDate(new Date('2024-01-01'))).toBe('2024-01-01'); }); // 关键：它检测到 format 参数有默认值，自动测试传入空字符串 it('handles empty format string', () => { expect(formatDate(new Date('2024-01-01'), '')).toBe(''); }); });

实操技巧：在codex test后加--coverage参数，它会运行测试并生成覆盖率报告，自动标记未覆盖的分支。

4.4 重构遗留代码（安全降级法）

面对 500 行的巨型函数，codex refactor --to functional可能引发灾难。正确做法是分步：

1. 先用codex extract --function calculateTotalPrice把函数拆成小单元；
2. 对每个小单元运行codex test生成回归测试；
3. 再对单个单元执行codex refactor --to async-await；
4. 最后用codex verify --against tests确认所有测试仍通过。

我曾用此法重构一个电商结算函数，原函数含 7 层嵌套 if-else，耗时 4 小时，零 bug 上线。

4.5 调试生产环境问题（无需 SSH）

当线上服务报错，传统做法是ssh登录、tail -f logs、ps aux | grep node。用 Antigravity：

# 在本地项目根目录运行（需提前配置好 SSH） antigravity debug --service payment-api --error "TimeoutError: request timeout"

它会：

• 自动 SSH 到生产服务器；
• 查找payment-api进程的 PID；
• 抓取该 PID 的strace -p <pid> -e trace=connect,sendto,recvfrom输出；
• 解析网络调用链，定位超时发生在调用auth-service:8080的第 3 次重试；
• 返回结论：“auth-service的/validateendpoint 响应时间 > 5s，建议检查其 Redis 连接池”。

注意：此功能需在~/.antigravity/config.yaml中配置ssh.host和ssh.user。

4.6 生成 API 文档（同步代码变更）

codex docs不是静态生成，而是监听文件变更：

# 启动文档监听 codex docs --watch src/api/controllers/

当UserController.ts被修改：

• 自动解析@Get(),@Post()装饰器；
• 提取@ApiParam()、@ApiResponse()的 JSDoc；
• 更新docs/api-reference.md，并高亮变更行；
• 发送 Slack 通知：“API 文档已更新：新增/users/{id}/profileendpoint”。

4.7 代码安全审计（CI 集成）

在 GitHub Actions 中加入：

- name: Run Codex Security Audit run: | codex audit --severity high --output sarif > codex-audit.sarif # 上传 SARIF 报告 gh codeql workflow upload-sarif --sarif codex-audit.sarif

它会扫描：

• 硬编码密码（匹配password:.*[a-zA-Z0-9]{12,}正则）；
• 过期依赖（比对npm outdated --json和 CVE 数据库）；
• 不安全的 deserialization（检测JSON.parse()的参数是否来自req.body）。

4.8 多语言代码转换（保真度控制）

codex translate支持指定保真度：

# 高保真：保留所有注释、空行、JSDoc codex translate --from ts --to py --fidelity high src/utils/math.ts # 低保真：只转换逻辑，忽略格式 codex translate --from ts --to py --fidelity low src/utils/math.ts

实测：fidelity high生成的 Python 代码，pylint评分 9.8/10；fidelity low生成的代码，black格式化后才达标。

4.9 性能瓶颈定位（火焰图集成）

codex profile可生成 Chrome DevTools 兼容的火焰图：

codex profile --target src/server/index.js --duration 30s # 输出 flamegraph.html，双击即可查看 CPU 热点

它会：

• 自动注入--inspect-brk启动 Node.js；
• 运行 30 秒后自动采集chrome://tracing数据；
• 生成 HTML，点击函数名可跳转到源码对应行。

4.10 团队知识沉淀（自动 FAQ 生成）

每周运行：

codex faq --from commits --since "2 weeks ago" --output docs/faq.md

它会：

• 解析最近两周的 commit message；
• 提取高频关键词（如redis,timeout,retry）；
• 生成 FAQ：

  Q: 为什么redis.set()有时超时？
  A: 检测到 3 次相关 commit，根本原因是连接池大小（maxConnections: 10）不足。解决方案：在redis.config.ts中将maxConnections提升至 50，并添加retry_strategy。

5. 常见问题排查与避坑指南：那些没人告诉你的细节

5.1 “Please verify your account to continue using Antigravity” 错误

这不是账号问题，而是 Antigravity 的许可证验证机制触发。根本原因是：

• 你修改了~/.antigravity/config.yaml中的license_key；
• 或者你的系统时间误差超过 5 分钟（Antigravity 使用 JWT 认证，时间偏差会导致 signature invalid）。

解决方案：

1. 运行antigravity license verify检查密钥状态；
2. 如果显示EXPIRED，访问 https://antigravity.dev/licenses 获取新密钥；
3. 如果显示INVALID_TIME，同步系统时间：

   # macOS sudo sntp -sS time.apple.com # Ubuntu sudo timedatectl set-ntp on

实操心得：我遇到过一次，是因为 Docker Desktop 的时间同步被禁用，导致容器内时间比宿主机慢 12 分钟。解决方案是在 Docker Desktop 设置中启用Use the host’s DNS configuration。

5.2 Claude Code 提示词泄露风险

Cursor 的“中文回复”设置（cursor.language）本质是向 Claude API 发送system prompt，内容为：“You are an expert developer. Please reply in Chinese.” 这个 prompt 会被 Anthropic 记录。如果你处理的是金融/医疗等敏感代码，必须禁用此功能。正确做法：

• 在 VS Code 中，用Claude Code插件的Claude: Toggle Language命令切换中英文；
• 或在settings.json中设置：

  "claudeCode.systemPrompt": "You are an expert developer. Reply in English unless explicitly asked for Chinese."

这样，只有当你输入请用中文解释时，才会触发中文回复，且 prompt 不包含敏感上下文。

5.3 Codex CLI 命令失效（/compact不生效）

常见原因有三个：

1. 文件未被纳入上下文：检查codex config get context.includePatterns，确认你要处理的文件类型在列表中；
2. 缓存污染：运行codex cache clear清空缓存；
3. 模型拒绝执行：Claude 3 对compact类指令有严格限制，如果代码含大量业务逻辑，它会返回I cannot perform this operation as it may alter behavior。此时改用codex refactor --to clean-code，它会保留行为，只优化可读性。

5.4 Cursor 中文设置失效

Cursor 的language设置只影响界面语言，不影响 AI 回复语言。要让 AI 用中文回复：

• 在编辑器中按Cmd+K，输入Switch to Chinese mode；
• 或在设置中搜索claudeCode.language，设为zh-CN；
• 关键：每次重启 Cursor 后，需重新运行Claude: Toggle Language，因为它的语言状态不持久化。

5.5 “Your organization has disabled Claude subscription access” 错误

这是 Anthropic 的企业版策略。如果你在公司网络下使用，管理员可能禁用了 Claude Code。解决方案：

• 联系 IT 部门，申请开通api.anthropic.com的出站访问；
• 或切换到本地模型（见 3.3 节），完全绕过 Anthropic 服务；
• 临时 workaround：在settings.json中添加：

  "claudeCode.fallbackTo": "local"

  当云端调用失败时，自动降级到本地模型。

5.6 Ubuntu 配置 Claude Code 卡在“Installing dependencies”

Ubuntu 22.04 的apt源有时会安装旧版libssl，导致 Node.js 的node-gyp编译失败。解决方案：

# 升级 OpenSSL sudo apt update && sudo apt install openssl libssl-dev # 重新安装插件 code --install-extension anthropic.claude-code

如果仍失败，强制使用预编译二进制：

mkdir -p ~/.vscode/extensions/anthropic.claude-code-2.4.1/node_modules/@anthropic-ai/runtime curl -L https://github.com/anthropic-ai/runtime/releases/download/v0.12.0/runtime-linux-x64.tar.gz | tar xz -C ~/.vscode/extensions/anthropic.claude-code-2.4.1/node_modules/@anthropic-ai/runtime

5.7 Cursor 无法跳转到 Source Insight 级别的代码块

Cursor 的Go to Definition默认只跳转到声明处，不支持 Source Insight 的“跳转到实现”（Go to Implementation）。启用方法：

• 在设置中搜索cursor.editor.gotoImplementation，启用；
• 或在代码中按Cmd+Alt+Click（Mac）/Ctrl+Alt+Click（Win）；
• 注意：此功能依赖 TypeScript 的tsserver，确保你的项目有tsconfig.json且compilerOptions.moduleResolution设为node。

5.8 删除 Codex CLI 指令的残留

卸载 Codex CLI 后，codex命令仍存在，是因为它被软链接到/usr/local/bin。彻底删除：

# 查找所有链接 ls -la /usr/local/bin | grep codex # 删除链接（通常为 codex -> /opt/codex/bin/codex） sudo rm /usr/local/bin/codex # 清理配置 rm -rf ~/.codex

避坑提醒：不要用npm uninstall -g @codex/cli，这只会删 node_modules，留下的二进制文件会继续干扰 PATH。

5.9 Cursor 免费额度耗尽后的应对

Cursor 免费版每月 1000 次调用，用