中转站推荐

用我邀请码有些送额度。

SuperAPI：倍率 0.02x ~ 0.1x
Auto-code：free 倍率 0.1x / plus 倍率 0.145x
Codex-For.Me：倍率 0.12x
TiMi CC：倍率 0.15x
CCTQ：倍率 0.15x

安装 nvm + Node + codex cli + PowerShell 7

安装 nvm 管理 Node 版本
Windows：Releases · coreybutler/nvm-windows
Linux/Mac：

# curl or wget
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

nvm 安装 Node（JavaScript 执行环境）
新开终端命令行。
```
# 安装 Node 24
nvm install 24
# 使用 Node 24
nvm use 24
```

安装 codex cli

# 安装 codex cli
npm i -g @openai/codex

Windows 推荐安装 PowerShell 7，让 Agent 优先使用性能更好的 pwsh 命令。
- 在 Windows 上安装 PowerShell 7 - PowerShell
- Releases · PowerShell/PowerShell

安装配置 CC Switch

下载地址：Releases · farion1231/cc-switch

不推荐直接修改 codex cli 配置文件（~/.codex/config.yaml和~/.codex/auth.json）来修改为第三方 API。
不推荐使用 CC Switch 时不开启本地路由和自动故障转移，不然切换供应商后还需要重启 Codex 或相关软件。

添加新供应商
- API Key 为中转站中创建的令牌/密钥，API 请求地址为中转站提供的线路，一定要/v1结尾。可以在后面”管理与测速“中添加多个地址。
- 推荐配置通用配置：
  - disable_response_storage = true：希望禁用响应存储功能，保持匿名。
  - service_tier = "flex"：希望走 Flex 层，价格更低，响应更慢。
  - [features]换行hooks = true：开启 Hook 功能，给其他 AI 工具使用 hook 注入。codex_hooks已弃用，请换成hooks，参考 Config basics – Codex | OpenAI Developers
  - model_context_window = 300000：最大上下文，按需设置。
  - model_auto_compact_token_limit = 250000：压缩阈值，按需设置。
- 可以勾选1M 上下文窗口，即每次会话最大上下文为 1M，如果达到压缩阈值会压缩上下文。轻量使用可以设置为 300000 和 250000。
本地路由：CC Switch 提供服务，Codex 使用时将请求发送到 CC Switch，CC Switch 再将请求转发给供应商，这样就不用重启 Codex。
自动故障转移：某个供应商失效时自动切换到下一个供应商
主页开启本地路由和自动故障切换。

Codex APP

Codex 有多种使用方式，推荐 Codex APP。

安装

Windows/Mac：Codex App | 桌面端多线程与工作树协作

Linux：

# 非 Arch 系 Linux
git clone https://github.com/ilysenko/codex-desktop-linux.git
cd codex-desktop-linux
make bootstrap-native

# AUR
paru -S openai-codex-desktop

安装后在File-Settings修改语言为中文，然后File-Exit后重新打开。
软件设置：
自定义指令：
- 实际就是修改~/.codex/AGENTS.md或C:\Users\xxx\.codex\AGENTS.md文件，具体提示词因人而异。
- PATHS: xxx=路径：当 Agent 过程中发现 AI 说找不到 xxx 目录，就自己定义一下。
- MUST: Search=rg：使用 rg 进行更快地文件和内容检索。安装：GitHub - BurntSushi/ripgrep
- RAW_OUTPUT_ONLY：仅输出原始数据和结果，避免答案前后加上诸如“好的，……”、“希望这能帮到你”之类的辅助性文字。
- NO_EXPLANATION：“无须解释”。
其他使用：
- 在输入框中按Shift Tab可以切换计划模式，先按照选项计划，再实现。
- Codex 的推理级别在处理普通任务时设置为高（high），在处理复杂任务时设置为超高（xhigh）。
- GPT-5.5 的价格是 GPT-5.4 的两倍，非难任务可以用 5.4。

Codex 增强和其他使用方式

Codex++：Codex App 的外部增强启动器和管理工具。
- 方式一：Releases · BigPizzaV3/CodexPlusPlus
- 方式二：包装器快速安装
```
npm i -g @duanluan/codex-plus-plus-launcher
```
- Arch 系 Linux
```
paru -S codex-plus-plus
```
Desktop CC GUI：类似 Codex APP 的客户端，功能更多。

下载地址：Releases · zhukunpenglinyutong/desktop-cc-gui
```
# Arch 系 Linux
paru -S ccgui-bin
```
终端命令输入codex使用 CLI：
- /model：切换模型
- /new：开启新对话
- /resume：恢复历史对话
- Codex 速查表 | 菜鸟教程
VS Code 使用 Codex 插件：

MCP 和 skill（Skills For Real Engineers & Superpowers）

Skill 网站
在 CC Switch 中添加
Skills For Real Engineers
这些 skills 是一套面向真实工程的 agent 工作方法，用来解决常见失败：需求没对齐、表达太啰嗦、代码缺少反馈、系统设计变差。核心不是让 agent 更会猜，而是让它先问清楚，再小步验证，并逐渐理解项目里的语言和设计判断。
- agent 最常失败在没真正理解你要什么。你以为它懂了，看到结果才发现方向偏了。所以要在动手前用/grill-me或/grill-with-docs让它追问细节，把目标、边界和取舍讲清楚。
- agent 啰嗦通常是因为不懂项目术语。/grill-with-docs会帮你建立共享语言，把关键概念和重要决策写进文档，让命名更一致，代码更好读，agent 也能更省 token 地思考。
- 代码质量取决于反馈。没有类型检查、浏览器验证和自动化测试，agent 就是在盲写。/tdd用红绿重构逼它先写失败测试再实现，/diagnose则把调试整理成可重复的步骤。
- agent 会加速编码，也会加速复杂度积累。所以这些 skills 把设计放到日常工作里：/to-prd先问会碰哪些模块，/zoom-out帮 agent 从整体理解代码，/improve-codebase-architecture用来定期改善项目结构。
```
# 安装
npx skills@latest add mattpocock/skills
```
Superpowers
启动编程 agent 后，只要它发现你要构建功能，就不会立刻写代码，而是先停下来追问：你真正想做什么。它会从对话中整理出规格说明，再拆成便于阅读和确认的小段给你看。
当你认可设计后，agent 会生成一份足够具体的实施计划：即使交给缺少项目背景、判断力有限、又不爱写测试的新手，也能照着执行。计划强调真正的红绿 TDD、YAGNI 和 DRY。
你说“开始”后，它会进入由 subagent 推动的开发流程：逐个完成工程任务，检查并评审结果，再继续推进。Claude 按计划自主工作几个小时而不跑偏，并不罕见。
这就是系统的核心。更多细节暂且不展开；关键在于这些 skills 会自动触发，你不用额外操作，编程 agent 自然就拥有了 Superpowers。
- Codex CLI：
```
# Codex CLI 中打开插件搜索界面
/plugins
# 直接输入搜索
superpowers
```
- Codex APP：点击侧边栏中的“插件”，搜索superpowers并安装。
- 请注意，同时使用mattpocock/skills和superpowers时，建议添加全局提示词：
```
Prefer skills installed from `mattpocock/skills` for normal engineering work, especially `grill-with-docs`, `diagnose`, `tdd`, and `improve-codebase-architecture`. Use Superpowers for large, long-running, or explicitly autonomous tasks.
```
Apifox 获取 MCP
Apifox MCP Server - Apifox 帮助文档
随便找一个接口。

Trellis：Agent 框架

Trellis - Trellis Doc
可以通过 Trellis 配置项目规范，比如测试环境地址、账号密码，那 AI 就可以去访问测试环境自行测试。
项目初始化和每次提问时，Trellis 还会自动根据代码和需求更新规范。可以自动归档任务。

场景	适用时机	Trellis 的主要价值
1. 从零开始新项目	新建产品、服务、包或内部工具	在代码扩散前把早期决策写清楚
2. 接入存量项目	仓库已存在，但规范主要靠人记忆	从真实代码提取模式，不打断业务开发
3. 交付产品功能	一个任务横跨产品、API、数据和 UI	让 scope、specs、实现和检查保持一致
4. 重构老模块	代码能跑，但已经难以安全修改	在保持行为不变的前提下，让结构可审查
5. 修复反复出现的 bug	同类问题多次出现	把修复沉淀成测试、spec 和会话记忆
6. 减少重复 Review 反馈	Reviewer 总是写同类评论	把 Review 规则提升为共享仓库上下文
7. 推广到团队	多人、多仓库或多 AI 工具要统一	让采用方式在开发者和 Agent 之间保持一致

# 安装
npm i -g @mindfoldhq/trellis
# 进入你的项目目录
cd your-project
# 配置，一直回车
trellis init -u your-name --codex

# npm 更新 trellis 新版后更新规范
trellis update

首次生成规范给 AI 发$update-spec，生成后查看.trellis/spec/backend/api-interface-guidelines.md的内容，不规范请提供参考类，及时更正。

建议提交.trellis/spec目录，新增.gitignore配置：

# AI
.agents
.codex
.trellis/**
!.trellis/spec/
!.trellis/spec/**
AGENTS.md
.claude
CLAUDE.md
.gitnexus

ccusage 统计用量

ryoppippi/ccusage: Analyze coding (agent) CLI token usage and costs from local data.

# 直接统计用量
npx ccusage@latest

# 安装后使用
npm i -g ccusage
ccusage

gitnexus 生成依赖调用关系执行流程

GitHub - abhigyanpatwari/GitNexus: GitNexus: The Zero-Server Code Intelligence Engine - GitNexo-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a GitHub repo or ZIP file, and get an interactive knowledge graph wit a built in Graph RAG Agent. Perfect for code exploration

# 全局安装 GitNexus CLI
npm i -g gitnexus
# 如安装 sharp 时遇到 node-gyp / libvips 编译问题，可强制使用 sharp 预编译包
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm i -g gitnexus

# 一次性初始化：安装 GitNexus skills，并配置 MCP
gitnexus setup

# 进入目标项目根目录
cd 项目目录

# 完整分析项目并注入 AI 上下文文件，适合 Claude Code 场景，会生成/更新 .gitnexus/、.claude/、CLAUDE.md、AGENTS.md 等
gitnexus analyze
# 仅生成/刷新 .gitnexus/ 索引，适合 Codex 场景，不改 CLAUDE.md、AGENTS.md 或 skills
gitnexus analyze --index-only

# 将当前项目已有 .gitnexus/ 索引登记到全局仓库列表，便于后续工具发现
gitnexus index .

# 查看已登记的全部 GitNexus 仓库
gitnexus list
# 查看当前项目索引状态、索引时间和提交是否匹配
gitnexus status

rtk：在命令输出到达 LLM 上下文之前进行过滤和压缩

GitHub - rtk-ai/rtk: CLI proxy that reduces LLM token consumption by 60-90% on common dev commands.

Windows 安装：在 Release · rtk-ai/rtk 下载rtk-x86_64-pc-windows-msvc.zip，解压到软件目录/rtk目录中，比如C:/Program Files/rtk，再配置到环境变量PATH中。

Linux/Mac：

# 脚本安装
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
# AUR 安装
paru -S rtk

# 配置到环境变量
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # or ~/.zshrc

命令：

# 这会安装一个 PreToolUse 钩子，透明地将 Bash 命令重写为 rtk 等价命令。
$ rtk init --global                                                                                                                 ✔  base   

Patch existing /home/njcm/.claude/settings.json? [y/N]  y
Enable anonymous telemetry? [y/N] n

# 初始化到 Codex
rtk init -g --codex
# 查看初始化情况
rtk init --show

# 统计节省
rtk gain
# ASCII 图表（30 天）
rtk gain --graph
# 发现遗漏的节省机会
rtk discover

提示词技巧

多用“参考”、“查看”、“根据”，提供足够的前置信息。

只看未提交内容提交，提交信息的格式按照历史提交：避免提交时只看聊天记录，出现明明是新增功能却说修复的情况，提交消息风格保持一致。
参考 24622fb7 提交：其中24622fb7为提交哈希。
前端/“某个”项目在……，需要基于“某个”项目/查看前端某某页面实现/哪些模块需要迁移/参考“某个”项目的24622fb7 提交：可以复刻其他项目中实现过的功能。
理解当前项目，生成 trellis spec：也可以使用$update-spec，参考命令、任务与规范 - Trellis Doc
前端/“某个”项目在……，生成 trellis spec，但不要污染本项目 spec：将需要参考的项目生成 spec
测试环境 base url 为……，生成 trellis spec：方便后续通过 Codex APP 的浏览器插件让 AI 自行调用测试。
根据[接口文档本地路径]，使用[某个技术，可以贴网址]对接 / 参考[之前对接的代码引用或路径]
审查未提交的更改：审查代码再看是否修复解决。
未提交内容逐行增加详细中文注释
解决 AI 总是回答上一个提问：使用/compact上下文压缩后再提问。

目录CONTENT

Codex AI Agent 全教程