侧边栏壁纸
  • 累计撰写 112 篇文章
  • 累计创建 48 个标签
  • 累计收到 6 条评论

目 录CONTENT

文章目录

Codex Agent 全教程

无尤
2026-05-08 / 0 评论 / 1 点赞 / 79 阅读 / 0 字

中转站推荐

安装 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 命令。

安装配置 CC Switch

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

  • 不推荐直接修改 codex cli 配置文件(~/.codex/config.yaml~/.codex/auth.json)来修改为第三方 API。
  • 不推荐使用 CC Switch 时不开启本地路由和自动故障转移,不然切换供应商后还需要重启 Codex 或相关软件。
开机启动 开启本地路由 开启故障转移 添加供应商
  • 本地路由:CC Switch 提供服务,Codex 使用时将请求发送到 CC Switch,CC Switch 再将请求转发给供应商,这样就不用重启 Codex。
  • 自动故障转移:某个供应商失效时自动切换到下一个供应商
  • 添加新供应商
    • API 请求地址中一定要/v1结尾,可以在后面”管理与测速“中添加多个地址。
    • 推荐配置通用配置:
      • disable_response_storage = true:希望禁用响应存储功能,保持匿名。
      • service_tier = "flex":希望走 Flex 层,价格更低,响应更慢。
      • [features]换行codex_hooks = true:开启 Hook 功能,给其他 AI 工具使用 hook 注入。
      • model_context_window = 300000:最大上下文,按需设置。
      • model_auto_compact_token_limit = 250000:压缩阈值,按需设置。
    • 可以勾选1M 上下文窗口,即每次会话最大上下文为 1M,如果达到压缩阈值会压缩上下文。轻量使用可以设置为 300000 和 250000。
  • 主页开启本地路由和自动故障切换。
    主页开启本地路由和自动故障切换

Codex APP

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

  • 安装

  • 安装后在File-Settings修改语言为中文,然后File-Exit后重新打开。

  • 软件设置:
    自动审查、完全访问权限、防止休眠、跟进行为(引导)
    个性务实、自定义指定
    会话按项目整理

  • 自定义指令:

    • 实际就是修改~/.codex/AGENTS.mdC:\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使用 CLI:
    Codex CLI

  • VS Code 使用 Codex 插件:

    VS Code 安装 Codex 插件
VS Code 使用 Codex 插件

Skill 和 MCP

Trellis

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

建议提交.trellis/spec目录,新增.gitignore配置:

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

rtk(TODO)

……

提问技巧(TODO)

……

1

评论区