企业官网建设流程全解析

1. 多项目并行时，Codex 的计划模式到底解决什么问题

如果你同时维护三四个仓库，一边改登录鉴权、一边补订单导出、一边还要给后台加权限，那大概率经历过这种场面：需求丢给 AI，它立刻开始改文件，改到一半你发现方向不对，回滚又得手动挑 diff。Codex 的计划模式（Plan Mode）就是冲着这个痛点来的——它让模型先把「要动哪些文件、装什么依赖、怎么验证」讲清楚，你确认之后才落笔写代码。

计划模式适合谁？适合首次搭项目、框架迁移、技术栈升级、复杂 Bug 修复这类多步骤任务。它不适合「把这一行 console.log 删掉」这种一句话能说清的小改。判断标准很简单：如果这个任务你自己动手前会先在纸上列个清单，那就该开计划模式。

而并行开发这块，Codex 配合 Git WorkTree 能做到每个功能一个独立目录，互不干扰。再往上，Skills 把重复操作固化成 SOP，MCP 插件把外部服务（浏览器、数据库、文档）接进来。这三层能力叠在一起，才是「多项目并行开发者」真正想要的形态。

这篇会给出config.toml和settings.json的可复制骨架，演示通过 TaoToken 统一 Key 接入，并附上并行任务切换与插件加载的验证动作。全程按「能跟着做」的标准写，配置项都标了作用。

2. 前置准备：用 TaoToken 统一 Key 打通 Codex 的 API 通道

Codex 的 CLI 和桌面应用都支持自定义 API 端点。多项目并行时最烦的是每个项目配一套 Key，改起来容易漏。我的做法是统一走 TaoToken 的 API 通道，一个 Key 覆盖所有仓库，配置只写一次。

TaoToken 官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台生成 Key。API 基地址是https://taotoken.net/api，注意这个地址不带任何查询参数，直接填进配置即可。

需要提前准备的东西：

• 一个 TaoToken 账号，控制台里创建好 API Key（形如sk-开头）
• 本机装好 Node.js 18+ 和 Git
• Codex CLI 已安装（npm i -g或官方安装脚本，按你系统来）
• 至少两个 Git 仓库，用来验证 WorkTree 并行

拿到 Key 之后，先别急着写进项目配置。建议用环境变量存一份，避免 Key 跟着仓库提交上去。Linux/macOS 在~/.zshrc或~/.bashrc里加：

export TAOTOKEN_API_KEY="sk-你的Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

Windows PowerShell 用setx TAOTOKEN_API_KEY "sk-你的Key"，然后重开终端。这样后面所有配置文件都能引用同一个变量，换 Key 只改一处。

注意：不要把 Key 硬编码进config.toml再提交到 Git。用环境变量引用，或者把配置文件加进.gitignore。

3. 可复制配置：config.toml 与 settings.json 骨架

Codex 的配置分两层：CLI 侧读config.toml，桌面应用侧读settings.json。两者都指向 TaoToken 的 API 通道，Key 从环境变量取。

3.1 config.toml 骨架

放在~/.codex/config.toml（没有就新建）。下面这份是实测能跑通的最小骨架：

# ~/.codex/config.toml model = "gpt-5-codex" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "responses" # 计划模式默认开启，避免模型直接动手 [plan] enabled = true require_confirmation = true # 并行任务相关 [worktree] auto_create = true base_branch = "main"

几个关键项说明：

base_url填 TaoToken 的 API 地址，env_key指向你刚才设的环境变量名，Codex 启动时会自动读取，不用把 Key 写进文件。wire_api按你用的模型接口类型填，responses对应新版接口，如果报协议不匹配就换成chat。

[plan]段控制计划模式行为。require_confirmation = true表示模型生成计划后必须等你确认才执行，这是计划模式的核心开关，别关掉。

[worktree]段让 Codex 在开新任务时自动建工作树，base_branch指定从哪个分支拉。

3.2 settings.json 骨架

桌面应用侧配置放在应用设置目录，结构如下：

{ "apiProvider": { "type": "custom", "baseUrl": "https://taotoken.net/api", "apiKeyEnv": "TAOTOKEN_API_KEY", "model": "gpt-5-codex" }, "planMode": { "defaultOn": true, "showPlanPreview": true }, "plugins": { "mcpServers": {}, "skillsDir": "~/.codex/skills" }, "worktree": { "enabled": true, "rootDir": "~/codex-worktrees" } }

apiKeyEnv同样引用环境变量，不写明文。skillsDir指向你放自定义 Skills 的目录，后面讲 Skills 时会往里丢.md文件。worktree.rootDir是所有工作树的父目录，建议放在项目仓库外面，避免被 Git 追踪。

两份配置改完，重启 Codex CLI 和桌面应用，让配置生效。

4. 验证请求：确认 Key 通了、计划模式生效、WorkTree 能建

配置写完不验证等于没写。这一节按顺序做三个验证动作，每个都有明确的成功标志。

4.1 验证 API 通道

CLI 里跑一条最简单的请求：

codex exec "回复 ok 两个字，不要做其他事"

如果返回ok，说明 TaoToken 的 Key 和 base_url 都通了。如果报 401，检查环境变量是否在当前终端生效（echo $TAOTOKEN_API_KEY看有没有值）；如果报连接超时，确认base_url是https://taotoken.net/api且没有多余斜杠。

4.2 验证计划模式

在任意一个 Git 仓库里启动交互模式，输入一个多步骤需求，比如「把项目里的 moment 替换成 dayjs」。观察模型反应：

• 成功标志：模型先输出一份计划，列出要改的文件、要装的依赖、验证方式，然后停下来等你确认，而不是直接改文件。
• 失败标志：模型直接开始编辑文件。这说明require_confirmation没生效，回去检查config.toml的[plan]段是否被其他配置覆盖。

确认计划没问题后回复「执行」，模型才开始动手。这一步的体感差异很明显：计划模式下你多了一次「刹车」机会。

4.3 验证 Git WorkTree 并行

先看当前仓库有哪些工作树：

git worktree list

然后在 Codex 里开两个并行任务，比如「给登录页加验证码」和「给订单页加导出按钮」。如果auto_create = true生效，Codex 会为每个任务建独立工作树。再跑一次git worktree list，应该能看到类似：

/path/to/main abc1234 [main] /path/to/wt-login def5678 [feature-login] /path/to/wt-export ghi9012 [feature-export]

每个工作树是独立目录，文件系统互不干扰。你在wt-login里改代码，不会影响wt-export。完成后各自提交，再合并回main。

4.4 验证插件加载

MCP 插件和 Skills 的加载验证放在下一节，因为要先配好插件本身。

5. Skills 与 MCP 插件：把重复操作固化成流程

计划模式和 WorkTree 解决的是「怎么并行」，Skills 和 MCP 解决的是「怎么不重复造轮子」。

5.1 Skills：本质是 Markdown 写的 SOP

Skills 就是放在skillsDir里的.md文件，每个文件定义一类任务的执行流程。比如代码审查的 Skill：

# code-review ## 触发场景 用户要求审查代码质量或提交前自检。 ## 检查项 1. 是否有未处理的 Promise rejection 2. 是否有硬编码的密钥或 token 3. 函数是否超过 50 行 4. 是否有未使用的 import ## 输出格式 按文件分组，每条问题标注行号和严重级别（高/中/低）。

把这个文件存成~/.codex/skills/code-review.md，CLI 里用/skills查看已加载列表，/skills install code-review安装。桌面应用在侧边栏插件市场里搜索，用$符号调用。

自定义 Skill 的关键是「检查项要具体、输出格式要固定」。写得太模糊，模型每次执行结果都不一样，就失去了 SOP 的意义。

5.2 MCP 插件：连接外部服务

MCP 是标准化接口协议，让 Codex 能操作浏览器、数据库、文档等外部工具。在settings.json的mcpServers字段里配置：

{ "plugins": { "mcpServers": { "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp"] } } } }

配好后重启应用，在对话里描述测试需求，比如「打开本地 3000 端口，测试登录流程，截图保存」。Codex 会调用 Playwright 启动浏览器、模拟操作、生成报告。

验证插件是否加载成功：在对话里输入/plugins或查看侧边栏插件列表，能看到playwright处于 active 状态即可。如果没加载，检查command路径是否正确、npx是否在 PATH 里。

5.3 agents.md：让 Codex 理解你的项目

在每个项目根目录放一个agents.md，写清楚项目背景、技术栈、常用命令、注意事项。这相当于给模型一份入职文档，它读完之后给出的计划会贴合你的项目实际，而不是泛泛而谈。

推荐内容结构：

# 项目说明 电商后台管理系统，React + TypeScript + Vite。 ## 常用命令 - 开发：pnpm dev - 构建：pnpm build - 测试：pnpm test ## 注意事项 - 不要直接改 src/generated 下的文件，那是自动生成的 - 提交前必须跑 pnpm lint

全局约束可以放在~/.codex/agents.md，比如代码风格、提交规范、禁止操作。项目级agents.md优先级高于全局。

6. 本篇常见错排查

配置过程中最容易卡住的几个点，按出现频率排：

Key 读取失败报 401：九成是环境变量没生效。CLI 和桌面应用可能读不同的 shell 环境，桌面应用从图标启动时不一定继承终端的环境变量。解决办法是在settings.json里确认apiKeyEnv名字拼写一致，或者临时用系统级环境变量（Windows 的「系统属性-环境变量」）设置。

计划模式不生效，模型直接改文件：检查config.toml里[plan]段是否被项目级配置覆盖。Codex 的配置有优先级，项目目录下的.codex/config.toml会覆盖全局配置。如果项目里有这个文件，把require_confirmation也加上。

WorkTree 建在了仓库内部导致 Git 混乱：worktree.rootDir一定要设在仓库目录外面。如果已经建在内部，用git worktree remove <path>清掉，改配置后重建。

MCP 插件加载后无响应：先确认npx能单独跑通（终端里手动执行一次npx -y @playwright/mcp看是否报错）。如果插件依赖浏览器，首次运行需要下载 Chromium，网络慢会卡住，耐心等或换镜像源。

Skills 调用后输出格式每次都不一样：Skill 文件里的「输出格式」段写得太宽松。把格式固定成模板，比如「每条问题一行，格式为文件:行号 [级别] 描述」，模型就会严格按模板输出。

切换并行任务时改错目录：WorkTree 多了之后容易在错误的目录里操作。养成习惯：每次切任务前先pwd确认当前路径，或者用git worktree list核对。Codex 桌面应用会在标题栏显示当前工作树，注意看。

7. 接入文档与后续动作

配置跑通之后，日常使用就是三件事的循环：开计划模式让模型先出方案、用 WorkTree 隔离并行任务、靠 Skills 和 MCP 把重复操作自动化。

如果你在接入阶段遇到 Key 或端点问题，直接看接入文档对照排查：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。需要管理多个项目的 Key 时，控制台的 API Keys 页面可以按项目分 Key，方便追踪用量：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

想先验证模型对话是否正常，不写配置也能试：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 。如果你打算长期用 Codex 做编码和 Agent 任务，Coding Plan 的额度模式比按次调用更划算：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。

最后留一个我踩过的坑：WorkTree 建多了之后磁盘占用涨得快，每个工作树都是完整的工作副本。定期用git worktree prune清理已删除的工作树记录，合并完的分支及时git worktree remove，不然半年后你会发现硬盘里躺着一堆废弃目录。