🎉 欢迎使用 AI合租 文档系统!返回主站 →
文档中心
💻 Codex CLI
VS Code 集成

VS Code 集成

Codex IDE 扩展允许开发者在编辑器中与 Codex 配对工作,可以读取、修改和运行代码,帮助构建更快速的应用、修复 bug 并理解陌生代码。

支持的编辑器

Codex 扩展兼容 VS Code 及其衍生版本:

  • Visual Studio Code
  • Cursor
  • Windsurf
  • VS Code Insiders

平台支持:macOS 和 Linux 为主要平台。Windows 支持仍处于实验阶段,推荐在 WSL 工作空间中使用。

安装步骤

1. 安装扩展

通过 Visual Studio Code Marketplace 或 IDE 特定的安装链接获取扩展。

2. 打开扩展

安装后,扩展图标会出现在左侧边栏。VS Code 用户可以将图标拖动到编辑器右侧以重新定位。

工作模式

Codex 提供三种工作模式:

Chat(聊天模式)

仅聊天,不会自动修改代码,适合规划阶段和讨论想法。

Agent(代理模式,默认)

可以自动读取、编辑文件并运行命令。涉及工作目录外的操作时需要用户批准,提供安全性保障。

Agent (Full Access)(完全访问模式)

完全自动化执行所有操作,无需用户批准。需谨慎使用,建议仅在完全信任的项目中启用。

模型与推理配置

推荐模型

  • GPT-5:默认模型,适合一般开发任务
  • GPT-5-Codex:推荐用于代理编码任务,针对代码生成优化

推理力度

可以调整推理力度以平衡响应速度和质量:

  • 低 (Low):快速响应,较少 token 消耗
  • 中 (Medium):平衡速度和质量
  • 高 (High):深度推理,更准确但响应较慢

使用技巧

文件引用

在提示中使用 @filename 标记引用打开的文件,实现更精准的上下文感知。

示例:

@app.js 这个文件中的登录逻辑有什么问题?

快捷键与命令

Codex 提供多个可自定义的命令,包括切换聊天窗口和添加上下文。

查看完整命令列表:

  1. 点击设置图标
  2. 选择 "Keyboard shortcuts"
  3. 搜索 "Codex" 查看所有可用命令

界面布局

VS Code 用户可以通过拖拽 Codex 图标来调整其在编辑器中的位置,根据个人偏好优化工作流程。

Windows 用户注意事项

由于 Windows 支持仍处于实验阶段,强烈推荐:

  1. 使用 WSL (Windows Subsystem for Linux) 工作空间
  2. 安装 WSL 扩展后,在 WSL 终端中使用 code . 启动 VS Code
  3. 将项目保存在 Linux 主目录中(如 ~/code/my-app

补充资源

详细文档和高级配置信息可在 GitHub 仓库获取: github.com/openai/codex (opens in a new tab)