news 2026/6/9 12:36:31

Codex怎么用?国内如何使用?最全CLI使用教程与高效技巧

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Codex怎么用?国内如何使用?最全CLI使用教程与高效技巧

如果你是一名程序员,大概知道OpenAI的Codex,最近关于Codex和Claude code谁更厉害的争得是愈演愈烈,虽然大家都在说Claude code好用,但是不乏一些资深的程序员说Codex好用。

给出的原因很简单:Codex的bug更少,上下文更长,唯一的缺点就是太慢了。

这里紧急插播一条新闻:GPT的模型已经提速了,提升了40%。


最近,Codex发布了macOS应用,这意味着国内越来越多的开发者可以便捷地使用它。不过很多人刚开始接触Codex时往往一脸懵它怎么安装?怎么用?为什么有这么多配置参数?

本文就来系统解决这些问题。我会从Codex的基本概念讲起,手把手教你在本地快速部署CLI环境,最后再分享15个我在实际开发中总结的高效使用技巧。这些技巧涵盖从快捷操作到高级配置,足以让你从新手升级到进阶用户。

如果你还想要使用Claude code,可以看我另外一篇文章,有介绍三种方法。

相关阅读:

手把手教你在国内使用 Claude Code:不封号、不折腾、比官网更便宜


一Codex是什么?为什么值得关注


Codex应该是OpenAI专为编程打造的AI模型。和通用的ChatGPT相比,它有几个明显优势。代码理解和生成能力远超通用模型,能准确把握编程逻辑、语法规范和最佳实践。

支持40多种编程语言,Python、JavaScript、Go都能轻松搞定。更关键的是,它不仅生成代码,还能理解代码、调试错误、重构逻辑基本是个高级程序员的升级版。

你可以在终端里敲命令(CLI),也可以在VS Code里弹出AI建议(IDE插件),还可以通过SDK集成到自己的应用,或者直接上网页用(云端)。本文主要讲CLI方案,因为它给开发者最大的灵活性。

虽然说得很AI感,但是用户唯一认可它的,就是好用。


那它到底能怎么用?

二、哪些用户可以使用Codex

目前只有付费用户才能使用Codex,比如Plus、Pro、Team等会员,如果你还不会开通会员,可以看我之前的文章。

相关阅读:

ChatGPT如何充会员?WildAI、Google Play、礼品卡5种方法实测对比

那免费用户可以用吗?其实也可以,只不过需要搭配着OpenAI的API才能用,在后面的使用技巧那里有详细的介绍,感兴趣的可以看看。

Codex安装教程,CLI环境快速上手:从零到启动

第一步:安装Node.js

Codex CLI基于Node.js开发,因此你首先需要在本地安装它。访问Node.js官网,按照你的系统版本(Windows/Mac/Linux)下载合适的安装程序。由于涉及命令行工具链,建议下载LTS长期支持版本,稳定性更好。

安装完成后,打开终端验证一下:

node -v npm -v
能看到版本号就说明安装成功了。


第二步:安装Codex CLI

现在用npm全局安装Codex:npm i -g @openai/codex

得到如下结果:


这条命令会从npm仓库下载Codex包并全局安装,这样你在任何目录下都能直接使用codex命令。安装可能需要一两分钟,取决于你的网络。


第三步:登录与验证

安装好后,在终端输入:codex


返回命令行窗口 ,显示如下界面

一直回车

输入hello测试一下,能正常返回结果即表示能够正常使用:


三、15个核心技巧:从基础到进阶


基础操作类

1. 设置别名加速启动

每次启动都要等待模型加载,有没有办法让常用配置预先生效?当然有。你可以为Codex设置别名,把常用参数绑定进去。

在Mac上,编辑你的shell配置文件:

echo "alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox'" >> ~/.zshrc source ~/.zshrc

Windows用户可以通过设置系统环境变量实现类似效果。这样下次只需输入codex,所有参数就自动加载了,省去手工调整的麻烦。

2. 快捷命令速查表

Codex内置了一套快捷命令系统。在会话中输入/就能看到所有可用命令。最常用的有三个——输入/model切换模型和推理等级,输入/new开启新会话,输入/status查看Token用量。想看更多?输入/就能把全部命令响光一遍。熟记这几个常用的,能推高工作效率。


3. 快速换行输入

编写复杂提示词时,长行代码看起来很凌乱。按Option + Enter(Mac)或Control + J(Windows/Linux)可以快速换行,让输入更易读。这个看似不起眼的快捷键,在处理多行指令时特别有用。

4. 中断与退出操作

Codex在执行任务时,有时需要打断。按ESC键或Control + C可以立即中断当前请求。如果想彻底退出会话,再按一次Control + C或直接输入/quit。这些操作给了你完整的控制权,避免被卡住。

5. 通过API使用Codex

如果你没有ChatGPT Plus订阅,也能通过付费API的方式使用Codex。修改配置文件~/.codex/config.toml,添加:preferred_auth_method = "apikey"

然后配置你的OpenAI API Key。这种方式特别适合企业用户或需要按需计费的场景。

更多费用明细查看官方说明:openai.com/api/pricing/



6. 切换模型与推理等级

Codex的核心是模型选择。默认使用的gpt-5.2-codex是OpenAI最强的代码专用模型,但你也可以根据需要切换。使用/model命令进入交互式选择,或者启动时指定参数:codex -m gpt-5.2 -c model_reasoning_effort="high"


推理等级有三档:低、中、高。高等级会花更长时间思考,但输出质量更好。我通常在解决复杂问题时用高等级,日常工作用中等级。

7. 权限模式精细控制

Codex默认用Auto模式——可以读写文件、运行命令,但跨目录操作需要你确认。只想聊天或规划?切换到Read Only只读模式,完全不用担心误操作。

需要自动化?用Full Access(但要小心!)。Auto是安全与效率的平衡;只读是探索学习时的保障;完全访问唯一的优先是效率最快。

8. 网络搜索能力激活

默认情况下,Codex只能访问本地数据。如果你需要它查询最新的库文档、API说明或Stack Overflow答案,启用网络搜索:codex --search


启用后,Codex会先上网收集信息再回答,答案会带有参考链接。这在处理快速变化的技术领域时特别有价值。

9. 初始化项目指导文件AGENTS.md

AGENTS.md是Codex特有的配置格式。你可以把它看作给AI编程助手准备的README——里面定义了项目结构、编程规范、目标文件等上下文。运行/init命令会自动生成默认的英文AGENTS.md,手动翻译成中文后效果更好。

一个完整的AGENTS.md能让Codex理解你的项目逻辑,显著提升代码质量。

10. 查看配置与Token用量

使用/status命令能看到当前会话的详细信息:账户状态、模型信息、已用Token数等。这对控制成本和调试问题都很有用。如果发现Token消耗过快,可能是上下文过大,考虑使用/compact压缩。

进阶功能类

11. 文件引用和图像输入

你可以用@文件名的方式直接引用项目中的文件,让Codex了解代码上下文。更强大的是,Codex支持图像输入——直接粘贴截图或使用-i参数附加图片文件:

codex -i screenshot.png "解释这个错误堆栈"
这在调试GUI应用或分析设计稿时特别管用。

12. 脚本执行与自动化

如果你想在CI/CD流水线中使用Codex,可以用exec命令以非交互方式运行:

codex exec "修复这个JavaScript的类型错误"
这让Codex不仅是交互工具,更成为自动化工作流的一部分。

13. MCP协议集成

Codex支持Model Context Protocol(MCP),这让你能集成第三方工具和数据源。比如连接到你的代码库、数据库或专业工具。编辑~/.codex/config.toml添加MCP服务器配置,就能扩展Codex的能力边界。

14. 上下文压缩

长期会话中,上下文会不断累积,最终触发限制。使用/compact命令能智能压缩历史记录,保留关键信息同时节省Token。这对长期项目特别重要。

15. 灵活的配置文件管理

所有配置都存在~/.codex/config.toml里。你可以为不同项目设置不同的信任等级和参数。比如:

model = "gpt-5-codex" [projects."/path/to/project"] trust_level = "trusted"
这种基于项目的配置让你能对不同工作采用不同策略,既安全又灵活。


国内用户特别提醒

如果你在中国使用Codex,有几点需要注意。首先,访问OpenAI服务需要稳定的网络环境。其次,如果用API方式,需要配置有效的支付方式。建议使用国际信用卡或通过代理服务商。

最后一个提示——Codex的价格取决于Token使用量。GPT-5-Codex的API价格最高,日常工作如果资源有限,可以考虑切换到成本更低的模型。但如果是商业项目,投资在最强的模型上往往能带来更高回报。


对于国内开发者而言,Codex 怎么用的核心难点在于网络环境的配置以及对 CLI 工具链的熟悉程度。通过 Node.js 安装 CLI,配置 API Key 解决认证问题,再配合 Alias 和 AGENTS.md 等技巧,你完全可以在本地打造一个比 GitHub Copilot 更强大、更可控的 AI 编程助手。

AI 不会淘汰程序员,但它是会淘汰那些不会使用 AI 的程序员。既然工具已经交到了你手上,不妨现在就打开终端,试着敲下那行 codex 吧。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/5 20:03:02

手摇专用蜗轮梯形丝杆升降机的工作原理是怎样的?

手摇专用蜗轮梯形丝杆升降机是蜗轮梯形丝杆升降机的手动特化简化款,专为无电、轻载、低频率精细调整场景设计,全程无任何电气部件,核心工作原理围绕 **“人力发力→力臂初级增扭→蜗轮蜗杆二次大减速比增扭 90 动力转向→梯形丝杆副将旋转转…

作者头像 李华
网站建设 2026/6/5 21:21:30

当视频开始“理解空间”:镜像视界正在改变人员安全管理方式——从二维监控到空间智能,重塑高风险作业区人员

当视频开始“理解空间”:镜像视界正在改变人员安全管理方式——从二维监控到空间智能,重塑高风险作业区人员安全范式发布单位:镜像视界(浙江)科技有限公司 应用场景:危化作业区|应急处置现场&am…

作者头像 李华
网站建设 2026/6/5 19:47:16

Google ProtoBuf 简介

目录 1. 概述 2.环境安装 2.1编译源码包 2.2下载源码并解压 3. 实例演示 3.1 书写proto文件 3.2 编译 .proto 文件 3.3 Writer.cpp代码 3.4 Reader.cpp代码 3.5 执行Writer和Reader 4. ProtoBuf的Encoding 4.1 Message Buffer 4.2 Varint 4.3 Key 4.4 Zi…

作者头像 李华
网站建设 2026/6/9 6:44:27

AI应用架构师须知:企业AI风险防控的5大技术趋势

AI应用架构师须知:企业AI风险防控的5大技术趋势 标题选项 AI应用架构师必读:企业AI风险防控的5大技术趋势与实践指南 驾驭AI风险:架构师视角下的5大核心技术趋势与防御策略 从风险到信任:AI应用架构师必须掌握的5大风险防控技术趋势 构建安全AI:企业级风险防控的5大技术趋…

作者头像 李华
网站建设 2026/6/6 8:28:30

20260205_185752_手把手带做_Agent_智能体,直接让你简历加大分!

你有没有过这种感觉,我们好像正在经历又一个类似移动互联网刚刚兴起的时代? 那时候,有的人抓住了机会,有的人还在观望,几年后,人与人之间的差距就悄然拉开了。如今,人工智能的浪潮来得更猛&…

作者头像 李华