Codex CLI 使用

本指南将帮助你通过 Codex CLI 在终端中使用 AI 编程助手。

开始之前

请确保你已准备好:

Codex CLI(终端)

1
安装

确保 Node.js 版本 ≥ 20(下载地址),然后执行:

npm install -g @openai/codex
2
登录

终端输入 codex,选择 Provide your own API key,然后输入 null

CLI 登录
选择 API key 登录

如果跳转到浏览器,请返回终端按 Esc 键跳过。

3
配置环境

与插件共用同一个配置文件,只需配置一次。参考 Codex 插件 的步骤 3(config.toml)和步骤 4(auth.json)。

4
启动

首次使用以下命令启动(之后直接 codex 即可):

codex --model gpt-5.3-codex
CLI 启动
首次使用指定模型启动

输入 /permissions 授权文件编辑权限。输入 codex resume 可恢复历史记录。

常见问题

按教程配置还是无法连接?

VSCode SSH 连接远程仓库怎么使用?

需要将 config.toml 配置文件复制到远程服务器的 ~/.codex 目录。

退出登录

CLI: 终端输入 codex logout。插件: 在插件设置中退出。

下一步