如何安装和使用 CodeX

CodeX 是什么？

CodeX是OpenAI推出的智能编程助手，通过CLI或Claude对话生成、补全、解释、重构多语言代码，支持长上下文推理和代理式开发，安全合规且高效，显著节省调试与交付时间，兼容云端与本地工作流，助力个人与团队快速交付高质量软件。

安装教程

1. 安装 Codex 官方原版包

npm install -g @openai/codex
# 或者
brew install codex

2. 创建目录

先删除 C:\users\你的用户\.codex（若有），然后再重新创建 C:\users\你的用户\.codex

3. 配置 API KEY

访问仪表板的「我的KEY」页面，创建并复制一个新的API密钥

4. 创建 auth.json 文件

在 .codex 目录下创建 auth.json 文件：

{
  "OPENAI_API_KEY": "填写你的Key"
}

5. 创建 config.toml 文件

删除 C:\users\你的用户\.codex 路径下已存在的 config.toml 文件（若有），然后新建一个 config.toml：

model_provider = "Modelgate"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.Modelgate]
name = "Modelgate"
base_url = "https://mg.aid.pub/codex-proxy"
wire_api = "responses"

注意

如果您使用 modelgate 网页端，base_url 为： https://mg.aid.pub/codex-proxy
如果您使用 modelgate 客户端，base_url 为： http://localhost:13148/codex-proxy

重要提示：请使用与您选择的端口对应的 Key：

• 使用客户端时，请填写客户端的 Key
• 使用网页版时，请填写网页版的 Key
• 两个端的 Key 不要混用，否则可能导致认证失败

6. 验证安装结果

重启终端后运行以下命令，确认安装成功

codex -V

在Vscode/Cursor中使用

在"拓展"页面搜索"Codex – OpenAI's coding agent",点击安装,安装完成后,在侧边栏点击对应名称的图标,出现对话框即可使用