[{"content":"概述 Codex 是 OpenAI 推出的 AI 编程智能体（coding agent）。它不只是补全代码，而是能读懂整个项目、自己修改文件、执行命令、跑测试，把一个自然语言描述的任务从头做到尾。\n目前 Codex 提供几种使用形态：\n桌面应用：Windows / macOS 客户端，图形界面，适合日常开发 命令行工具 Codex CLI：在终端里用，适合脚本化和自动化 Web 云端版本：在浏览器里把任务丢给云端执行 IDE 扩展：集成在 VS Code 等编辑器里 本文以 Windows 桌面版 为例，记录从下载安装到登录、上手的完整流程。\n一、安装 Codex 1. 打开官网 访问 Codex 官方页面：\nhttps://openai.com/zh-Hans-CN/codex/\n页面加载后，中间会有一个下载按钮，官网会自动识别你的系统并推荐对应版本（Windows 显示「下载 Windows 版」）。\n2. 下载并运行安装包 点击按钮下载安装程序：\nWindows：下载 .exe，双击后按提示「下一步」完成安装 macOS：下载 .dmg，拖入 Applications 即可 安装完成后首次启动，客户端需要初始化运行环境，可能要等几十秒到一两分钟，属于正常现象。\n系统要求：建议 Windows 10 1809 及以上 / macOS 12 及以上。Windows 上如果要用命令行版本，还需要 WSL2。\n二、登录 Codex Codex 支持两种认证方式，按自己的情况选一种即可。\n方式一：ChatGPT 账号登录（推荐） 启动后会进入欢迎页，选择「使用 ChatGPT 账号登录」，浏览器会跳转到 OpenAI 授权页，登录并授权后自动回到客户端。\n这种方式的优点是不需要单独付费买 API 额度，直接复用 ChatGPT 的订阅（Plus / Pro / Business 等方案均可）。如果你的订阅额度用完了，客户端会提示等待重置或升级。\n方式二：使用 API Key 如果不想订阅 ChatGPT，也可以按量计费的方式使用：\n打开 https://platform.openai.com/api-keys 点击「Create new secret key」生成一个 Key 复制 sk- 开头的字符串，粘贴到 Codex 的设置里 注意：API Key 等同于账号密码，绝对不要提交到 Git 仓库或截图分享。建议设置用量上限，避免意外产生高额费用。\n三、使用 Codex 1. 打开一个项目 登录后进入主界面，选择「打开文件夹」，指向你的代码目录。Codex 会扫描项目结构，建立索引。\n建议一次只打开一个项目，这样它理解上下文更准确，也不容易误改其他目录的文件。\n2. 用自然语言描述任务 在对话框里直接说人话，例如：\n「修复登录页在移动端按钮错位的问题」 「给这个函数补上单元测试」 「把项目里的 console.log 都换成统一的日志工具」 Codex 会先阅读相关文件，然后给出改动方案。默认情况下它不会直接动手，而是把 diff 展示给你确认。\n3. 审查并批准改动 这一步是整个流程里最重要的：逐条看它改了什么。\n确认没动到不相关的文件 确认逻辑符合预期 确认没有把密钥、内网地址写进代码 没问题就点接受，有问题直接回复让它重做。不要因为\u0026quot;看起来能跑\u0026quot;就一路点通过。\n4. 权限模式 Codex 通常提供几档权限，按信任程度选择：\n模式 能做什么 适用场景 只读 只读代码、给建议 刚接触、想先观察 可编辑 改文件，但执行命令前询问 日常开发（推荐） 完全自动 自主改文件、跑命令 熟悉之后、沙箱环境 5. 常用技巧 写清上下文：说明技术栈、希望改哪个文件、验收标准是什么 小步提交：一个任务一个任务来，改动太大会难以审查 让它先解释：不确定时先问「你打算怎么改」，确认思路再放行 善用 AGENTS.md：在项目根目录放一个 AGENTS.md，写明代码风格、构建命令、禁止事项，Codex 会自动读取 配合 Git：动手前先 git commit 或开新分支，改坏了随时回滚 四、附：命令行版本 如果你更习惯终端，Codex CLI 也很值得一试。需要先装 Node.js（18 及以上）：\nnpm install -g @openai/codex 然后在项目目录下直接运行：\ncodex 首次运行会引导你登录。常用命令：\ncodex # 进入交互模式 codex \u0026#34;解释这个项目的结构\u0026#34; # 单次提问 codex resume # 继续上一次会话 codex --help # 查看全部参数 配置文件在 ~/.codex/config.toml，可以设置默认模型、审批策略和沙箱模式。\n五、常见问题 Q：登录时浏览器授权后没反应？ 检查是否被防火墙或代理拦截。可以尝试在设置里改用 API Key 登录。\nQ：提示额度不足？ ChatGPT 订阅有使用频率限制，等额度重置即可；API Key 方式则需要到平台充值。\nQ：它改坏了我的代码怎么办？ 用 Git 回滚：git checkout -- .。这也是为什么建议动手前先提交一次。\nQ：国内网络能用吗？ Codex 依赖 OpenAI 的服务，网络访问情况和 ChatGPT 一致，按你平时使用 ChatGPT 的方式配置即可。\n小结 Codex 的价值不在于\u0026quot;帮你写几行代码\u0026quot;，而在于把一个完整任务交出去：读代码、改文件、跑验证。但它本质上是个执行者，方向和审查仍然要人来把握。\n上手建议：先用只读模式观察几轮，熟悉它的表达方式；再切到可编辑模式，配合 Git 小步推进。用顺手之后，效率提升会非常明显。\n","date":"2026-10-17T10:00:00+08:00","permalink":"/posts/codex-install/","title":"Codex 安装与使用指南"},{"content":"写在最开始 你好，欢迎来到 Q-note——这是我个人博客的第一篇文章。\n我决定把这里打造成一个长期沉淀的空间：记录学习笔记、收藏有用资源、写下偶尔的思考。\n站点规划 这个博客主要会包含以下几类内容：\n技术笔记：工作中遇到的坑、常用命令、踩过的雷 读书与思考：书摘、随笔、想法 生活杂谈：偶尔的日常与风景 技术选型 本站使用 Hugo + Stack 主题搭建：\nHugo：业界最快的静态站点生成器之一 Stack：卡片式设计、视觉舒适、配置简洁 写在最后 写作是思考的最佳外化。希望这些文字能帮到未来的我自己，也或许能帮到偶然路过的你。\n一图胜千言，一文胜千思。\n下一篇见。\n","date":"2026-09-28T10:00:00+08:00","permalink":"/posts/hello-qnote/","title":"你好，这是 Q-note"},{"content":"概述 本文记录从零开始用 Hugo + Stack 主题搭建本地博客的完整流程，涵盖安装、配置、写作与预览。\n一、安装 Hugo extended Stack 主题使用 SCSS 编译，必须安装 extended 版本：\n# Windows (PowerShell) Invoke-WebRequest -Uri \u0026#39;https://github.com/gohugoio/hugo/releases/latest/download/hugo_extended_0.167.0_windows-amd64.zip\u0026#39; -OutFile hugo.zip Expand-Archive hugo.zip -DestinationPath C:\\Hugo $env:Path += \u0026#39;;C:\\Hugo\u0026#39; hugo version 二、新建站点 hugo new site blog cd blog 三、引入主题 下载 Stack 主题 v4 解压到 themes/hugo-theme-stack/，然后在 hugo.toml 中启用：\ntheme = \u0026#34;hugo-theme-stack\u0026#34; 四、新建文章 hugo new posts/hello-world.md 文章 front matter 示例：\n--- title: \u0026#34;你好，世界\u0026#34; date: 2026-09-28T10:00:00+08:00 draft: false tags: [\u0026#34;开篇\u0026#34;] categories: [\u0026#34;随笔\u0026#34;] --- 五、本地预览 hugo server -D 浏览器访问 http://localhost:1313/ 即可看到效果。\n常见问题 ⚠️ 警告 启动报 TOCSS: failed to transform 错误？说明安装的是非 extended 版本，请重新下载。\n💡 提示 修改 hugo.toml 后无需重启 hugo server，会自动热重载。\n小结 Hugo + Stack 的组合上手成本低、视觉效果好 配置文件 hugo.toml 是定制的核心 文章统一放在 content/posts/ 下，前置 YAML 控制元信息 下一篇将分享 Stack 主题的进阶玩法与定制技巧。\n","date":"2026-09-27T14:30:00+08:00","permalink":"/posts/hugo-stack-quickstart/","title":"Hugo + Stack 主题快速上手"},{"content":"概述 Stack 主题是我用过最舒服的 Hugo 主题之一——卡片化设计、配置直观、生态完善。但凡事总有两面，本文记录一些不直观的地方与踩过的坑，希望能帮后来者少走弯路。\n一、必须使用 Hugo extended 主题使用 SCSS/TS 编译，如果用普通版 Hugo，启动会直接失败：\nError: TOCSS: failed to transform \u0026#34;scss/style.scss\u0026#34; 📌 重要 下载时务必选择文件名包含 extended 的版本。\n二、Widgets 配置 Stack 的 widgets（小部件）分两类：\nwidgets.homepage：首页右侧栏 widgets.page：文章页右侧栏 支持的类型：search、archives、categories、tag-cloud、taxonomy、toc。\n示例：\n[params.widgets] homepage = [ { type = \u0026#34;search\u0026#34; }, { type = \u0026#34;archives\u0026#34;, params = { limit = 8 } }, { type = \u0026#34;categories\u0026#34;, params = { limit = 10 } }, ] page = [ { type = \u0026#34;toc\u0026#34; }, { type = \u0026#34;search\u0026#34; }, ] 三、搜索页必须存在 要使用搜索功能，必须先创建 content/page/search.md：\n--- title: \u0026#34;搜索\u0026#34; layout: \u0026#34;search\u0026#34; --- 否则侧栏虽然能看到搜索框，但点击后会 404。\n四、暗色模式 主题支持跟随系统的暗色模式：\n[params.colorScheme] toggle = true default = \u0026#34;auto\u0026#34; default 可选 light / dark / auto。\n五、文章分析 主题内置 Google Analytics：\n[services.googleAnalytics] ID = \u0026#34;G-XXXXXXXXXX\u0026#34; 💡 提示 国内站点也可通过 layouts/partials/extend_head.html 自定义脚本接入不蒜子、百度统计、Umami 等。\n六、目录与代码块 目录显示需同时启用 params.article.toc = true 与侧栏 type = \u0026quot;toc\u0026quot; widget。 代码块支持 100+ 语言高亮，使用 ```lang 标记即可。 七、封面图建议 推荐比例 16:9 或 3:2，分辨率 ≥ 1200×630，否则在小屏会被强制放大模糊。\n小结 主题门槛低，但 extended 版本是硬性要求 搜索、归档、目录等高级功能都依赖显式创建页面或显式启用 widget 暗色模式、GA、字体等都可以精细定制 工具是骨架，文章才是灵魂。\n","date":"2026-09-26T20:15:00+08:00","permalink":"/posts/stack-theme-tips/","title":"Stack 主题使用心得与踩坑记录"}]