HoRain云--Codex 核心概念

📅 2026/7/17 13:37:14
HoRain云--Codex 核心概念
在使用 Codex 之前理解几个核心概念非常重要。这些概念构成了 Codex 工作的基础。Prompt提示词你通过发送 Prompt 与 Codex 交互描述你想要它完成的任务。Prompt 工作循环当你提交 Prompt 后Codex 按以下循环工作调用语言模型理解任务执行模型输出指示的操作读取文件、编辑代码、运行命令将操作结果反馈给模型循环执行直到任务完成或你取消Codex 采用Agent 循环模式工作——模型输出指示操作操作结果反馈给模型循环往复直到任务完成。有效 Prompt 的原则原则说明示例包含验证步骤Codex 能验证工作时输出质量更高写一个函数包含测试用例验证它处理空列表拆解复杂任务小任务更容易测试和审查第一步创建模型完成后告诉我再继续第二步提供上下文引用相关文件和图片参考 src/auth.py 的风格实现类似功能Codex 处理小而专注的任务时表现最好。大任务应拆分为小步骤逐步执行。Thread线程/会话Thread 是单个任务会话你的 Prompt 加上后续的模型输出和工具调用。线程类型类型运行环境特点本地线程你的机器沙箱内可读写文件、使用现有工具、执行命令云端线程云端隔离环境克隆仓库运行、适合并行任务、跨设备委派线程使用规则运行中的线程可以并发但需要注意避免两个线程同时修改同一文件线程可以稍后通过继续另一个 Prompt 来恢复长时间任务可能会自动压缩上下文Context上下文当你提交 Prompt 时包含 Codex 可以使用的上下文——对相关文件和图片的引用。上下文来源IDE 扩展自动包含打开的文件列表和选中文本范围手动指定在 Prompt 中引用文件路径或附加图片对话历史线程中之前的对话内容上下文窗口线程中的所有信息必须适合模型的上下文窗口。Codex 会监控并报告剩余空间。当接近限制时你会收到提示。自动 Compact对于较长的任务Codex 可能会自动压缩上下文。压缩机制会总结相关信息丢弃不太重要的细节释放空间继续处理。管理上下文# 开始新会话释放上下文/new# 查看当前上下文使用情况/status当 Codex 报告上下文使用量较高时考虑开始新会话或减少历史消息。Sandbox沙箱Sandbox 是 Codex 的安全隔离机制防止意外修改工作区外的文件。沙箱模式模式文件修改网络访问适用场景Read-only禁止禁止只读分析、代码审查Workspace-write仅工作区禁止日常开发默认Full-access允许允许完全信任的环境谨慎使用Approval审批机制某些操作需要你的确认才能执行执行 Shell 命令特别是 rm、kill 等修改或删除文件访问敏感目录如 ~/.ssh/、/etc/网络请求设置沙箱模式# 在 CLI 中切换沙箱模式codex --sandbox workspace-write# 或在 Prompt 中指定分析这个代码不要修改任何文件沙箱是 Codex 安全策略的第一道防线确保 AI 操作不会超出预期范围。Approval Policy审批策略审批策略控制 Codex 执行操作前是否需要确认。策略类型策略说明行为ask每次询问敏感操作前请求确认默认approve自动批准自动执行无需确认谨慎使用deny自动拒绝拒绝所有可能产生副作用的操作配置审批策略# ~/.codex/config.tomlapproval_policy ask总结理解这些核心概念后你可以更有效地使用 CodexPrompt清晰描述任务包含验证步骤Thread管理任务会话注意并发规则Context提供相关上下文监控窗口使用Sandbox了解安全机制选择适当模式常见问题Q: Prompt 应该用中文还是英文Codex 支持多语言但英文通常效果最好。使用中文时确保描述足够详细和明确。Q: 如何查看当前线程状态使用/status命令查看线程 ID、上下文使用量和配置信息。Q: 上下文窗口满了怎么办开始新会话/new或让 Codex 自动压缩历史记录。Q: 沙箱模式可以动态切换吗可以在 CLI 启动时指定或在配置文件中设置默认值。