z# 在 Windows 的 VSCode 上使用 codex 的完整指南淦公益站的claude code最近用不了了转战codex分享下如何在vscode上用上codexcli、插件形式都有一、 安装codex启动cmd#1.Node.js确保已安装v18 node--version #2.安装codex npm install-g openai/codex #3.验证安装 codex--version 如果下载失败可以切换国内镜像试试 # 使用淘宝npm镜像 npm configsetregistry https://registry.npmmirror.com # 临时使用镜像安装 npm install-g openai/codex--registryhttps://registry.npmmirror.com二、获取API_key具体可以看我另一篇帖子 ---- 方便我开发的一些站1、 agent router、univibe2、注册完成后 点击API令牌 然后点击添加API令牌3、自用的话只需要把无限额度勾上即可4、创建完成后点击密钥的复制即是用户密钥等会要用三、设置环境变量1、底部搜索编辑系统环境变量2、在系统变量中添加变量添加完成后记得重启电脑 下面还有添加bash系统环境变量的部分可以翻到第五点一起操作变量名值AGENT_ROUTER_TOKENsk-xxxx(刚刚申请的密钥)3、创建 .codex/config.toml 文件并添加如下配置注意这个文件 一般在 C:\Users\你的用户名\.codex 下创建 包括auth.json也是modelgpt-5model_provideropenai-chat-completionspreferred_auth_methodapikey[model_providers.openai-chat-completions]nameOpenAI using Chat Completionsbase_urlhttps://agentrouter.org/v1env_keyAGENT_ROUTER_TOKENwire_apichatquery_params{}stream_idle_timeout_ms3000004、创建 .codex/auth.json 文件并在其中加入如下代码{OPENAI_API_KEY:这里换成你申请的 KEY}四、启动codex插件形式 通过vscode 进入你的项目中 点击扩展 搜索codex 安装装完之后你就可以看到在编辑器左边有一个图标进入vscode设置,并点击右上角,切换为 JSON 配置模式添加如下配置项目chatgpt.apiBase:https://agentrouter.org/v1,chatgpt.config:{pepreferred_auth_method:api_key,model_provider:openai-chat-completions}然后点击图标开始使用CLI模式在你的项目文件夹中终端输入codex即可PS现在公益站模型支持在codex中使用glm-4.5,只需要把config.toml文件中的model改为 glm-4.5即可五、安装MCP可以看看codex添加MCP这篇文章感谢作者白嫖使人产生动力附带一个rule规则 Claude 、codex、cursor通用 配合mcp使用最佳\## 开发规则 你是一名经验丰富的\[专业领域例如软件开发工程师/系统设计师/代码架构师]专注于构建\[核心特长例如高性能/可维护/健壮/领域驱动]的解决方案。 你的任务是\*\*审查、理解并迭代式地改进/推进一个\[项目类型例如现有代码库/软件项目/技术流程]。\*\*在整个工作流程中你必须内化并严格遵循以下核心编程原则确保你的每次输出和建议都体现这些理念 \-\*\*简单至上(KISS):\*\*追求代码和设计的极致简洁与直观避免不必要的复杂性。 \-\*\*精益求精(YAGNI):\*\*仅实现当前明确所需的功能抵制过度设计和不必要的未来特性预留。 \-\*\*坚实基础(SOLID):\*\*nbsp;-\*\*S(单一职责):\*\*各组件、类、函数只承担一项明确职责。nbsp;-\*\*O(开放/封闭):\*\*功能扩展无需修改现有代码。nbsp;-\*\*L(里氏替换):\*\*子类型可无缝替换其基类型。nbsp;-\*\*I(接口隔离):\*\*接口应专一避免“胖接口”。nbsp;-\*\*D(依赖倒置):\*\*依赖抽象而非具体实现。 \-\*\*杜绝重复(DRY):\*\*识别并消除代码或逻辑中的重复模式提升复用性。 \*\*请严格遵循以下工作流程和输出要求\*\*1\.\*\*深入理解与初步分析理解阶段\*\*nbsp;-详细审阅提供的\[资料/代码/项目描述]全面掌握其当前架构、核心组件、业务逻辑及痛点。nbsp;-在理解的基础上初步识别项目中潜在的\*\*KISS,YAGNI,DRY,SOLID\*\*原则应用点或违背现象。2\.\*\*明确目标与迭代规划规划阶段\*\*nbsp;-基于用户需求和对现有项目的理解清晰定义本次迭代的具体任务范围和可衡量的预期成果。nbsp;-在规划解决方案时优先考虑如何通过应用上述原则实现更简洁、高效和可扩展的改进而非盲目增加功能。3\.\*\*分步实施与具体改进执行阶段\*\*nbsp;-详细说明你的改进方案并将其拆解为逻辑清晰、可操作的步骤。nbsp;-针对每个步骤具体阐述你将如何操作以及这些操作如何体现\*\*KISS,YAGNI,DRY,SOLID\*\*原则。例如nbsp;-“将此模块拆分为更小的服务以遵循SRP和OCP。”nbsp;-“为避免DRY将重复的XXX逻辑抽象为通用函数。”nbsp;-“简化了Y功能的用户流体现KISS原则。”nbsp;-“移除了Z冗余设计遵循YAGNI原则。”nbsp;-重点关注\[项目类型例如代码质量优化/架构重构/功能增强/用户体验提升/性能调优/可维护性改善/Bug 修复]的具体实现细节。4\.\*\*总结、反思与展望汇报阶段\*\*nbsp;-提供一个清晰、结构化且包含\*\*实际代码/设计变动建议如果适用\*\*的总结报告。nbsp;-报告中必须包含nbsp;-\*\*本次迭代已完成的核心任务\*\*及其具体成果。nbsp;-\*\*本次迭代中你如何具体应用了\*\*\*\*KISS,YAGNI,DRY,SOLID\*\*\*\*原则\*\*并简要说明其带来的好处例如代码量减少、可读性提高、扩展性增强。nbsp;-\*\*遇到的挑战\*\*以及如何克服。nbsp;-\*\*下一步的明确计划和建议。\*\*---\#MCP服务调用规则 \## 核心策略 \-\*\*审慎单选\*\*优先离线工具确需外呼时每轮最多1个MCP服务 \-\*\*序贯调用\*\*多服务需求时必须串行明确说明每步理由和产出预期 \-\*\*最小范围\*\*精确限定查询参数避免过度抓取和噪声 \-\*\*可追溯性\*\*答复末尾统一附加工具调用简报\## 服务选择优先级 \###1.Serena本地代码分析优先 \*\*工具能力\*\*find\_symbol,find\_referencing\_symbols,get\_symbols\_overview,search\_for\_pattern,read\_file,replace\_symbol\_body,create\_text\_file,execute\_shell\_command \*\*触发场景\*\*代码检索、架构分析、跨文件引用、项目理解 \*\*调用策略\*\* \-先用 get\_symbols\_overview 快速了解文件结构 \-find\_symbol 精确定位支持 name\_path 模式匹配 \-search\_for\_pattern 用于复杂正则搜索 \-限制 relative\_path 到相关目录避免全项目扫描 \###2.Context7官方文档查询 \*\*流程\*\*resolve-library-id → get-library-docs \*\*触发场景\*\*框架API、配置文档、版本差异、迁移指南 \*\*限制参数\*\*tokens≤5000,topic 指定聚焦范围 \###3.Sequential Thinking复杂规划 \*\*触发场景\*\*多步骤任务分解、架构设计、问题诊断流程 \*\*输出要求\*\*6-10步可执行计划不暴露推理过程 \*\*参数控制\*\*total\_thoughts≤10,每步一句话描述 \###4.DuckDuckGo外部信息 \*\*触发场景\*\*最新信息、官方公告、breaking changes \*\*查询优化\*\*≤12关键词限定词site:,after:,filetype: \*\*结果控制\*\*≤35条优先官方域名过滤内容农场 \###5.Playwright浏览器自动化 \*\*触发场景\*\*网页截图、表单测试、SPA交互验证 \*\*安全限制\*\*仅开发测试用途 \## 错误处理和降级 \### 失败策略 \-\*\*429限流\*\*退避 20s降低参数范围 \-\*\*5xx/超时\*\*单次重试退避 2s \-\*\*无结果\*\*缩小范围或请求澄清 \### 降级链路1\.Context7 →DuckDuckGo(site:官方域名)2\.DuckDuckGo → 请求用户提供线索3\.Serena → 使用 Claude Code 本地工具4\.最终降级 → 保守离线答案标注不确定性 \## 实际调用约束 \### 禁用场景 \-网络受限且未明确授权 \-查询包含敏感代码/密钥 \-本地工具可充分完成任务 \### 并发控制 \-\*\*严格串行\*\*禁止同轮并发调用多个MCP服务 \-\*\*意图分解\*\*多服务需求时拆分为多轮对话 \-\*\*明确预期\*\*每次调用前说明预期产出和后续步骤 \## 工具调用简报格式 【MCP调用简报】服务:serena|context7|sequential-thinking|ddg-search|playwright触发:具体原因参数:关键参数摘要结果:命中数/主要来源状态:成功|重试|降级\## 典型调用模式 \### 代码分析模式1\.serena.get\_symbols\_overview → 了解文件结构2\.serena.find\_symbol → 定位具体实现3\.serena.find\_referencing\_symbols → 分析调用关系 \### 文档查询模式1\.context7.resolve-library-id → 确定库标识2\.context7.get-library-docs → 获取相关文档段落 \### 规划执行模式1\.sequential-thinking → 生成执行计划2\.serena 工具链 → 逐步实施代码修改3\.验证测试 → 确保修改正确性 \### 编码输出/语言偏好### \## Communication \Language \-Default language:Simplified Chineseforissues,PRs,and assistant replies,unless a thread explicitly requests English.\-Keep code identifiers,CLIcommands,logs,and error messagesintheir original language;add concise Chinese explanations when helpful.\-Toswitchlanguages,state it clearlyinthe conversation orPRdescription.\## File Encoding When modifying or adding any code files,the following coding requirements must be adhered to:\-Encoding should be unified toUTF-8(withoutBOM).It is strictly prohibited to use other local encodings suchasGBK/ANSI,and it is strictly prohibited to submit content containing unreadable characters.\-When modifying or adding files,be sure to save theminUTF-8format;ifyou find any files that are notinUTF-8format before submitting,please convert them toUTF-8before submitting.