vscode使用codex指的是在 VS Code 里安装 OpenAI 官方 Codex 扩展,把云端编程代理接到编辑器里。它不是传统自动补全,而是能接完整任务的代理,免费档先跑本地活,云端能力从 Plus 解锁。
vscode使用codex从安装扩展开始
先把扩展装对。在 VS Code 里按 Ctrl+P 打开命令框,输入 ext install openai.chatgpt 回车,扩展就会从市场拉取安装。习惯命令行的,也可以在外面执行 code --install-extension openai.chatgpt 直接装。这个扩展的标识符是 openai.chatgpt,发布者显示为 OpenAI,产品名是 Codex - OpenAI's coding agent。安装时留意 VS Code 版本是否满足扩展要求,版本过旧可能装不上或功能残缺,更新到较新的稳定版再装最稳。
装完后侧边栏会出现 Codex 入口,点开就能看到对话面板和任务区。这里要提醒一句:市场里名字带 Codex 的条目不止一个,认准发布者是 OpenAI 的那一条,别装成名称相近的第三方仿冒扩展,发布者不对,后面登录和调用都不会正常。装好并登录后,建议先在本机跑一次本地聊天,确认面板能正常收发,再交给它改一段你自己的代码,走通本地闭环再碰云端任务,这样出问题能定位是哪一层。
登录要走对通道
扩展装好后第一件事是登录,而且登录通道要跟你的订阅对上。大多数用户用的是 ChatGPT 账号,在扩展里选 Sign in with ChatGPT,支持的范围是 Plus、Pro、Business、Edu、Enterprise。如果你持有的是 GitHub Copilot Pro 或 Max 权益,路数不一样:要走 VS Code Insiders 版本,选 Sign in with Copilot,并在 Agent Sessions 视图里操作。Insiders 是 VS Code 的每日预览版本,稳定性不如稳定版,但 Copilot 通道的代理能力先在它上面放出,想用这条通道就得接受这个前提。 两个通道不能混。用 ChatGPT 账号去点 Copilot 通道,或者用 Copilot 权益去走 ChatGPT 登录,结果都是功能不生效。动手前先确认自己手里是哪类订阅,选对应的入口,省得来回折腾还以为是安装出了问题。登录成功后,扩展会把会话挂在当前账号下,切账号要先退出再登,不要在同一窗口里来回切,否则任务归属容易乱。
免费档能跑哪些活
Codex 扩展分本地和云端两层能力,免费档覆盖的是本地这一层。具体说,免费档能做本地聊天、能编辑你自己机器上的代码,这些是不要钱的。一旦要动用云端代理,比如把一整件事交给沙箱去跑、让代理跨文件改代码,就需要付费档位撑着。
价格阶梯是这么排的,具体以结账页显示为准。免费档 0 美元,Go 档每月 8 美元,Plus 每月 20 美元,Pro 有 100 美元(约 5 倍额度)和 200 美元(约 20 倍额度)两档,Business 每席每年 25 美元,Enterprise 走定制报价。多数个人开发者从 Plus 起步就能解锁主要云端能力。
| | |
|---|
| | |
| | |
| | |
| 100 或 200 美元,额度约 5 至 20 倍 | |
| | |
额度不是每天或每月发固定条数,而是按 5 小时滚动窗口计算。窗口内额度用尽就等窗口重置,不能靠跨天或跨月硬凑。理解这一点,能少很多关于限额的困惑。要估自己够不够用,看的是单次任务的体量和频率,而不是一个月调几次。零星派活免费档都够,真把它当主力、天天丢大任务,Plus 或 Pro 才划算。先拿免费档试两周,再决定升哪一档,最稳。
Codex 和补全不一样
很多人第一次接触会把它当成另一个 GitHub Copilot,这是最大的误会。Copilot 偏内联自动补全,你写着代码它顺着上下文给下一行建议。Codex 扩展是云端代理,你把一件事交代下去,它在隔离沙箱里跑完整任务,再把改动以 diff 的形式交回来,由你审阅后应用。正因任务在云端跑,大段改动不用占你本机算力,本机该干啥干啥,代理跑完通知你验收,这是它和本地补全在体感上最明显的分野。
所以两者节奏完全不同:补全是一行一行跟着你,代理是一件一件替你跑。代理适合收拾一个模块、补一组测试、做一轮重构这类成片的工作;补全适合边写边续、补小段逻辑。计费也各自独立,别以为买了其中一个另一个就自动能用。还有一层差别在上下文:代理拿的是你交给它的文件和指令,补全拿的是光标附近的上下文,前者更适合成片改动,后者更适合细碎续写。同一个编辑器里两者可以并存,按活的粒度分工,比硬二选一顺手。真要分工,就让补全管打字时的顺手,代理管成片的活,两者不抢同一段注意力。
对话面板怎么调起
日常最常用的入口是对话面板,快捷键是 Cmd 或 Ctrl 加 Shift 加 I,按出来就能直接和代理聊。在面板里可以引用文件,用 @ 加上文件名把上下文喂给它,让它基于具体文件作答而不是凭空猜。一次少引用几个文件比一股脑全选更稳,上下文越聚焦,代理越不容易被无关代码带偏。多个文件要一起看时,用 @ 逐个点名比拖整目录更清楚,代理也更容易抓到你想改的那一处。
| | |
|---|
| Cmd 或 Ctrl 加 Shift 加 I 调起 | |
| | |
| | |
| | |
| | |
| 输入 /fix /test /doc /explain /review /optimize | |
斜杠命令能把常见动作一键化,比如 /fix 让它改 bug,/test 让它补测试,/doc 让它写注释和文档,/optimize 让它做性能优化。先用对话把需求说清,再切斜杠命令让动作标准化,是上手最快的组合。面板里也能随时清空上下文重开一轮,上一轮聊偏了就别硬拽,重开比纠错省时间。
改完代码如何验收
代理返回的是改动,不是自动入库的提交。它把 diff 递回编辑器,你在里面逐处看每一处改动,确认逻辑对、范围对、没有顺手改到别的东西,再手动应用并提交。这个审阅环节别跳过,代理再强也只是按你给的上下文办事,边界没说清它就可能动到不该动的地方。新手常犯的错是把整个需求一句话丢过去,回来一堆改动再抱怨代理乱改。根子往往在派活时已经定了。
给代理派活前,先在对话里把范围讲明白:改哪个文件、达到什么效果、不改哪些部分。范围越具体,回来的 diff 越干净,你验收也越省力。验收时重点看三件事:有没有引入新依赖、有没有改到无关文件、有没有把占位或示例当真。确认无误后,应用改动走编辑器里的应用入口,不要在面板外手动复制粘贴,避免把代理没改到的行也带进去。改完顺手跑一遍相关测试,代理给的方案逻辑通不代表边界都覆盖,测一遍才放心。
国内网络怎么处理
扩展本身能装,但调用要能访问 OpenAI 的服务。所在网络连不通时,登录会卡、任务会迟迟不回,这不是扩展坏了,而是连通性问题。先把网络这一层解决,再谈怎么用代理。连通正常后,登录态和任务都在云端,本机断网期间派出的任务不会丢,恢复连接后回来接着看结果。
项目协作上还有一个省心做法:在项目根目录放一个 AGENTS.md,把技术栈、目录约定、禁止操作写进去,代理每次会读它来对齐做法。比每次口头交代稳,也减少代理跑偏的概率。多仓库或敏感代码,记得在 AGENTS.md 里划清边界,别让代理碰不该碰的分支。AGENTS.md 只写项目约定,不要往里塞密钥和凭证,那些东西该走环境变量,写进文档反而增加泄露面。
常见问题与注意点
- 认准官方发布者:扩展标识符 openai.chatgpt,发布者 OpenAI,产品名 Codex - OpenAI's coding agent,别装名称相近的仿冒条目。
- 两通道不混用:ChatGPT 账号走 Sign in with ChatGPT,Copilot Pro 或 Max 走 Insiders 的 Sign in with Copilot,登错功能不生效。
- 免费档只跑本地:本地聊天和本机代码编辑免费,云端代理、PR 审查、Slack 集成从 Plus 起。
- 限额是滚动窗口:用量按 5 小时滚动窗口算,不是每天或每月固定条数,用尽等窗口重置。
- 代理在沙箱跑:任务在隔离环境执行并返回改动,敏感仓库先划清范围,别让代理动不该动的分支。
- 改完先审再合:代理给的是 diff,应用前在编辑器逐处看改动,确认无误再提交。
- 配 AGENTS.md:项目根放 AGENTS.md 写清约定,代理读它对齐做法,比临场口头交代稳。
- 国内要联网:调用需访问 OpenAI 服务,网络不通时登录和任务都卡,先解决连通。
- 别交凭证:任何要账号密码或验证码的非官方页面都不要提交,官方登录在编辑器内完成。
还有一些零散疑问,一并整理在这里。
Q:vscode使用codex免费吗?
A:有免费档,但免费档只覆盖本地聊天和编辑自己机器上的代码。云端代理、GitHub 自动 PR 审查、Slack 集成、后台云任务这些要从 Plus 档开始。
Q:安装命令是什么?
A:在 VS Code 里按 Ctrl+P 输入 ext install openai.chatgpt 回车,或用命令行 code --install-extension openai.chatgpt。扩展标识符是 openai.chatgpt,发布者 OpenAI。
Q:和 GitHub Copilot 是一回事吗?
A:不是。Copilot 偏内联自动补全,Codex 扩展是云端代理,在隔离沙箱接完整任务再返回改动。两者计费与通道各自独立。
Q:Plus 和 Pro 差多少?
A:Plus 每月 20 美元,Pro 有 100 美元(约 5 倍额度)和 200 美元(约 20 倍额度)两档,额度按 5 小时滚动窗口发放,具体以官方结账页为准。
Q:限额按天算还是按月算?
A:按 5 小时滚动窗口算,不是每天也不是每月固定条数。窗口内额度用尽就等窗口重置,跨天或跨月都救不回。
Q:和 Codex 命令行版有什么不同?
A:扩展上下文是当前打开的文件,且带内联补全;命令行版上下文是整个项目、没有补全,更适合批量跑任务。按活挑顺手的。
Q:国内环境能用吗?
A:扩展能装,但调用要访问 OpenAI 服务,网络连不通就登录和任务都卡。先解决连通再谈使用。
Q:怎么让代理更懂我的项目?
A:在项目根目录放 AGENTS.md,写清技术栈、目录约定、禁止操作等,代理会读它来对齐做法,比临场口头交代稳。
Q:代理改的代码会直接入库吗?
A:不会直接入库。代理返回的是改动 diff,你在编辑器里逐处查看,确认后手动应用并提交,控制权在你手上。
回到开头,vscode使用codex的本质是在 VS Code 里接一个云端编程代理:装对 openai.chatgpt 扩展、走对登录通道,免费档先把本地聊天和编辑用起来,需要云端能力再升 Plus。它不是 Copilot 式自动补全,而是接任务、跑沙箱、回 diff 的代理,改完记得逐处验收再合。按这个节奏上手,多数日常编码场景都能平稳接住。