https://..com/codex/ide

装完之后在编辑器里就能直接调用 Codex。

至此，你已然拥有四条路径。对于新手而言，建议自 App 起始，而开发者则建议从 CLI 着手，那些已然配有 仓库的人员能够径直尝试云端版。

别纠结入口，工具不是对象codejock 16，不需要从一而终。

六、在 CLI 端使用 Codex

Codex 那儿形态最像“开发者工具”的是 CLI，你在终端讲需求，它于项目里改文件，它在项目中跑命令，它在项目内修问题。

1. 启动

codex

首次启动会让你选择登录方式。

还有可能会报错：Error: /read TUI

有人在官方的那个“issue”里，把这个错给复现出来了耶，只要重新去登录一下，它就又再次恢复到之前那样子啦，是这样的情况哟。

别就这种问题强行去刚，先进行登出操作，之后再登录，很多情形下，这要比你花费半小时去研究日志更具效果。

直接执行：

codex logout

或者一步到位：

codex login

浏览器登录一遍基本就好了，很多人都是这样修复的。

2. 登录方式

方案一：Sign in with （推荐）

会打开浏览器，用你的 账号授权。

方案二：Enter API Key

创建一个 API Key，将其粘贴进这个对应链接里。此方式依据token来计费，适用于那些已然习惯API的用户。

3. 模型选择

模型以你当前客户端显示为准。

此处在这不易死记硬背型号，因为AI工具更新速度极快，今日眼前所见的默认模型，在过了一段时期之后极有可能已然出现变化了。

如果想切换模型，用 /model 命令。

4. 30 秒上手

已安装妥善，首先来运行一回进行尝试，切勿一开始便促使其对祖传系统实施重构，应先借助小游戏展开练习以使心态更显健康，如此这般。

在 D 盘新建一个test文件夹，然后打开终端输入命令：

cd d:\test\

然后输入下面命令：

codex "用 Python 写一个贪吃蛇的游戏"

事情就这般简易，Codex能够领会你的需求，进而生成代码，接着创建文件，甚至于帮你运行。

一开始并不需要告知它具体运用何种框架、怎样去组织代码，它会率先依据需求作出相应的判断。这便是 AI 编码工具所具备的核心价值所在：即对你予以负责描述目标的要求，它相应负责进行拆分任务、修改文件以及运行命令。

试过这一个之后，你便会了解到 Codex 大体是何种感觉，此后再将它放置到真实项目当中，其价值将会更加显著。

当然，AI写代码与人写代码无异，皆需你。切莫将其视作全然无需检查的自动交付机器。

5. 常用命令

七、在 App 端使用 Codex

1. 启动

有两类人适合App，一类人是不想始终待在终端里面的， 另一类人是期望同时查看项目文件、对话记录以及修改内容的。

有一种打开方式，是直接去双击位于桌面的Codex图标，还有一种打开方式则是去执行命令codex app。

选择你的偏好后，点击继续，也可以点击跳过，后面再配置。

鉴于我先前登录过Codex CLI，因此App这一侧无需登录便能够直接予以使用。后续的IDE插件亦是如此这般情况，同一套登录状态能够进行复用。

2. 基础使用

点开项目，而后挑选使用已有的文件夹，寻得方才上面制作贪吃蛇的那个名为test的文件夹。

能看到，方才的对话业已全被加载进来了。这一点意义重大： Codex具有这样的特性，它并非仅仅可作单次问答，而是会围绕着某个项目持续不停地开展工作。

单击右上角的切换文件树，能够瞧见当前目录下的文件。点击特定文件之后，左侧能够进行内容预览，也能够径直在文件里添注释，以便 Codex依照你的反馈接着去修改。

此时，它不再仅是，“问答机器人”，而是能够围绕项目上下文持续展开修改。

右下角那儿的设置之中，还能够去查看剩余的额度。轻度的使用情况下，一般而言是够用的，不过额度的策略会产生变化，最终是以客户端所显示的情况作为标准的。

八、在云端使用 Codex

云端版适宜于处置已然放置到上面的项目，你能够将其理解为，本地Codex是于你电脑上开展工作，云端Codex是连接至你的仓库里开展任务。

要是你已然拥有仓库，那么能够径直跳转到“连接 Codex 到 ”。后续这段乃是从无到有创建仓库的完备流程。

1. 初始化 Git 仓库

打开终端输入命令cd d:\test\

然后执行以下命令：

git init

执行完成后，可以看到 App 上面多了一个提交的按钮。

点击进行提交操作，于提交消息当中填写一段提交说明内容，接着点击持续前进，如此这般我们的修改记录便储存下来了。

这里别学某些老项目，全员都提交信息，好多好多年之后去查记录，自己都会恨不得朝着自个儿狠狠抡上一拳。

2. 创建 远程仓库

接下来我们打开 ，创建一个名为test的远程仓库。

创建完成后可以看到这些提示。

我们于刚刚开启的终端里行动，去执行以下这般命令，留意将下面提出的地址替换成为你自身的仓库地址。

git remote add origin https://github.com/ailot/test.git

执行完毕之后，能够见到，App之上的推送按钮，变成了可以点击的状态了。

在刚才的终端继续执行命令。

git branch -M main
git push -u origin main

在执行完第二条命令后，会提示你登录 。

选用浏览器去登录，凭借你的进行登录那个，一旦产生这个界面临时就意味着达成成功了。

终端同样可以看到推送成功的日志。

仓库也能够看到我们刚刚推送的文件。

3. 连接 Codex 到

打开

点击，那个位于https://.com/codex/cloud 处的，`连接到 `。

点击继续

选择进行授权。

然后我们进入云端 Codex 了。

按照如下步骤配置远端代码仓库。

挑选方才我们于其上构建的test仓库，接着点击&，录入密码予以授权。

当你去进行页面的刷新操作时，此时能够看到，我们所拥有的test仓库，其已然是处于Codex这个范围里面了标点符号。

我让它看一下这是个什么项目。

这一步特别适宜拿来检验 Codex 是不是领会了仓库，别才一开始就叫它“重构整个系统”，先询问它“这是个怎样的项目”。

把提示词输完之后，进行点击发送的操作，随后能够看到，下方出现了某个情况，有一个任务正在被创建并且处于执行的状态。

点击进去可以看到具体的执行结果。

九、IDE 端使用 Codex

适合日常进行代码编写的人所使用的 IDE 插件，其最大价值并非在于“再开启一个聊天窗口”，而是能够直接去读取当下项目的上下文情况，在你编写代码所处的位置为你实施修改。

这样的情形，是特别契合那种在书写进程当中，忽然滞碍停顿的一瞬间的：脑袋表示自己已经领会了，然而手却宣称你就放过我吧。

打开，然后安装Codex IDE 插件，具体操作如下：

在完成安装之后，重新启动VS Code，接着，打开我们刚刚位于D盘的test文件夹codejock 16，同样地，能够看到刚刚那些对话都已经被加载进来了。

后面还想怎么改，可以直接在对话框里面指挥。

我建议你从这几个场景开始用：

IDE插件具备的优势体现在，其上下文关联更为紧密，这种情况下适宜在编写过程中同步进行修改；CLI所拥有的优势在于，它存在更强的执行力，基于此条件适合促使它去连贯且完整地执行一项任务。

简单说：IDE 插件适合边写边问，CLI 适合直接派活。

十、进阶用法

1. .md 配置文件

于项目根目录那儿去创建一个.md 文件，以此告知 Codex 有关你项目的规范，这个文件是具备相当重要性的，它等同于给 Codex 撰写一份“项目说明书”。

# 项目规范
- 语言：Python 3.11+
- 代码风格：PEP 8
- 测试框架：pytest
- 注释：中文注释

如果你是新手，可以先用下面这个更完整的模板：

# AGENTS.md
## 项目说明
这是一个 Python 项目，主要用于练习小游戏开发。
## 开发规范
- 使用 Python 3.11+
- 代码保持简单，优先可读性
- 新增功能时同步更新 README
- 修改代码后尽量运行测试或启动程序验证
## 交互偏好
- 先解释修改思路，再改代码
- 涉及删除文件、重构目录、安装依赖时先询问
- 回复使用中文
## Codex 特定配置
- 权限模式：自动审查（关键操作需确认）
- 默认模型：qwen3.6-plus（或 gpt-5.5）
- 技能路径：./.codex/skills（如有）

这样，Codex在后续生成代码时，在执行跑命令这件事的时候，于解释相关问题之际，就能更符合你那关于项目的习惯了。

AI编码工具并非没有干活的能力，而是它不清楚你项目的规则，.md就是要先把规则清晰地写出来，避免每次都再次进行说明。

2. 常用场景

Codex 不只是写代码，还能：

3. 安全模式

有几种常见权限模式是属于Codex的，在不同版本界面当中，其里面的中文翻译，或许会存在略微的一些差异，不过呢，核心思路大致是相同的：

新手推荐配置：

起初的时候切勿一下子就彻底地给予权力，要等到你对Codex的行为方式熟悉之后，再一步步地放开权限。

十一、接入国内大模型

国内诸多平台给出了，具备兼容性的 API，一旦去更改一下配置，以及环境变量，便存在着这样一种机会，能够使得 Codex 运用国内模型。

但这里要先说清楚： 兼容不等于 Codex 一定可用。

Codex的新版本，对API的依赖程度更高了，要是平台仅仅只与Chat兼容，那么就有可能出现，能够连接得上，然而却无法正常运行的状况。

1. 支持的平台

本次我们选择阿里百炼的大模型。

为什么选它？主要是它这边适配情况相对更好，折腾成本低一点。

2. 配置方法

打开 App 的设置，进入配置文件进行修改。

将.toml里面的配置改成下面内容：

model = "qwen3.6-plus"
model_provider = "bailian"
[model_providers.bailian]
name = "bailian"
env_key = "BAILIAN_API_KEY"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"

然后在本地配置环境变量，具体步骤如下：

选中此电脑，点击右键，选择属性。

配置相关环境变量信息。

然后重启 Codex，配置即可生效。

3. 验证国内模型是否生效

配置完成后，用这个简单任务测试一下：

用中文写一个 Python 脚本，打印"Hello 国内大模型"，然后运行它。

当Codex，能够理解中文指令，进而生成代码，并且成功运行时，这就表明配置生效了。

十二、常见问题

在大家安装以及进行使用 Codex 的这个过程当中，并不一定就是能够顺顺利利的，小灰在这儿把几个 Codex 使用时经常会出现的问题以及解决办法罗列出来：。

如有侵权请联系删除！