Codex桌面端支持本地写代码、运行脚本、生成桌面宠物及操控浏览器和文件系统，安装后需授权ChatGPT账号并配置中转API（国内用户），再通过自然语言生成并一键运行脚本，还可启用桌宠与斜杠命令实现高级功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在本地电脑上直接用 Codex 写代码、跑脚本、生成桌面宠物、甚至操控浏览器和文件系统，不用开网页、不依赖 IDE 插件、不配 Python 环境——只要装好桌面端，登录即用，所有操作都在一个窗口里完成。
安装与首次启动
打开 Microsoft Store（Windows）或 Mac App Store（macOS），搜索 “Codex”，认准发布者为 OpenAI 的官方应用，点击“获取”安装。Mac 用户若从官网下载 .dmg 包，双击后拖入 Applications 文件夹即可。
安装完成后，首次启动会自动跳转浏览器完成 ChatGPT 账号授权。注意：必须完成这一步，否则后续无法加载项目目录、调用文件系统或启用 Computer Use 功能。
授权成功后，桌面端自动刷新进入主界面。此时左下角状态栏应显示绿色“Online”，右上角头像旁出现模型名称（如 gpt-5.5）。
配置中转 API（国内用户必做）
如果你在国内无法直连 OpenAI 服务，需配置第三方中转 API 才能正常使用。推荐使用 yunaicode 或 iThinkAPI，两者均支持 Responses 协议且延迟稳定。
方法一：手动修改配置文件
进入用户目录下的 .codex 文件夹（Windows 路径示例：C:\Users\用户名\.codex；macOS 路径：~/.codex）。若该文件夹不存在，请手动创建。在其中新建两个文件：config.toml 和 auth.json。
在 config.toml 中填入以下内容（请勿复制空格或中文标点）：
model_provider = "yunaicode"<br>model = "gpt-5.5"<br>disable_response_storage = true<br>preferred_auth_method = "apikey"<br><br>[model_providers.yunaicode]<br>name = "yunaicode"<br>base_url = "https://cdn.yunaicode.com/v1"<br>wire_api = "responses"
在 auth.json 中写入你的 API Key：{ "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }。⚠️密钥必须以 sk- 开头，且不能有多余逗号或换行。
保存后，完全退出 Codex 进程（任务管理器中结束所有 codex.exe 或 Codex 进程），再重新启动。
快速生成第一个可运行脚本
点击左上角「+ New Task」新建任务，输入自然语言需求，例如：“写一个 Python 脚本，遍历当前目录下所有 .txt 文件，统计每行字数并输出到 summary.csv”。
按下回车后，Codex 会在右侧生成完整代码，并自动高亮关键变量和函数名。不要直接复制粘贴——点击右上角「Run」按钮，它会自动在内置终端执行该脚本。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
如果脚本需要读写本地文件，Codex 会弹出权限确认框，勾选「Allow file access」并点击「Confirm」。这一步不可跳过，否则脚本将因权限拒绝而报错 OSError: Permission denied。
执行成功后，终端输出 summary.csv 已生成，同时左侧项目树中会自动出现该文件。双击即可在内置编辑器中查看。
启用桌宠与皮肤切换
在任意对话框中输入 $skill-installer hatch-pet 并发送，Codex 会自动下载并注册 Hatch Pet 技能。安装完成后重启应用。
重启后，在新任务中上传一张清晰正面人像或宠物照片，输入提示词：“请根据这张图生成一张角色设定图，包含正面、侧面、背面、3/4视角及站立、挥手、跳跃三个动作，风格为扁平插画，背景透明。”
生成完成后，点击右上角「Settings」→「Appearance」→「Pet Skin」，选择刚生成的图片作为桌宠源图。Codex 会自动切分成多帧动画并挂载到右下角。
此时桌宠已激活：当 Codex 正在思考时，它会微微晃动；代码运行中，它会奔跑；任务完成，它会挥手。你可随时拖拽它到屏幕任意角落，不影响其他窗口。
用斜杠命令调用高级功能
在输入框中键入 /，会弹出命令菜单。常用命令包括：
• /mcp：启动多步协作编程模式，适合拆解复杂需求（如“先建数据库表，再写增删改查接口，最后加单元测试”）；
• /review：对当前项目中的全部 .py 或 .js 文件进行批量代码审查，标出潜在 bug 和安全风险；
• /plan：将模糊需求转化为分步执行计划，例如输入“帮我做一个记账小工具”，它会列出 UI 设计→数据存储→增删改查→导出报表 四个阶段，并为每步生成可执行命令。
执行 /plan 后，Codex 不会直接写代码，而是生成带编号的步骤列表。你可以点击任意一步旁的「▶」符号，让它立即执行该子任务。
