为什么需要Codex中文版？
Codex是OpenAI开源的终端AI编程助手，能直接理解代码库并自动完成修改、运行测试等操作。然而，国内开发者直接安装官方版本时，常遇到网络连接不稳定、API Key申请困难、模型响应延迟高等问题。本教程基于Codex中文网整理的社区方案，提供一键安装脚本，自动完成环境配置、镜像替换和国产大模型接入，让您像使用本地工具一样流畅使用Codex。
准备工作
开始安装前，请确认您的系统满足以下条件：
1. 操作系统：Ubuntu 20.04+、CentOS 8+、macOS 12+或Windows 10/11（WSL2环境）。
2. 已安装Node.js 18+和npm，可通过 node -v 验证。
3. 拥有一个国产大模型API密钥（如DeepSeek、通义千问、Kimi或智谱GLM），也可以使用OpenAI兼容接口的中转服务。
一键安装步骤
打开终端，执行以下命令（Windows用户请在WSL2的终端中执行）：
bash -c "$(curl -fsSL https://codex-cn.example.com/install.sh)"
该脚本会自动完成以下操作：
1. 检测系统环境，自动安装缺失的依赖；
2. 将Codex官方源替换为国内镜像源，加速下载；
3. 配置OpenAI兼容的API端点，默认指向您选择的国产大模型；
4. 创建交互式配置向导，引导您填入API Key和模型名称；
5. 设置终端别名，使 codex 命令全局可用。
安装完成后，脚本会提示您重新加载终端配置，并输出 Codex 中文版安装成功 的绿色字样。
配置国产大模型
一键安装默认支持DeepSeek和通义千问。您也可以手动修改配置文件 ~/.codex/config.toml，示例内容如下：
[model]
provider = "deepseek"
name = "deepseek-coder"
api_base = "https://api.deepseek.com/v1"
api_key = "sk-您的密钥"
如果使用其他兼容OpenAI接口的模型，只需修改 provider 为 openai，并将 api_base 指向对应服务地址即可。脚本还支持环境变量方式注入密钥，适合CI/CD场景。
使用示例
安装完成后，在任意项目目录下运行 codex 进入交互界面。例如，输入 帮我修复这个项目的测试用例，Codex会自动分析代码结构、定位问题并生成补丁。您也可以使用 codex run 直接执行非交互式任务：
codex run "给所有Python文件添加类型注解"
Codex会读取本地代码，调用国产大模型进行推理，并在终端中展示修改建议。确认后，它会直接修改文件并运行测试验证。
常见问题
Q：安装脚本提示无法连接镜像源怎么办？
A：请检查网络代理设置，或手动将脚本中的镜像地址替换为您的内网源。
Q：调用模型时返回401认证错误？
A：请确认API Key是否有效，并检查 config.toml 中的 api_base 是否与模型服务商一致。
Q：如何升级Codex中文版？
A：重新运行一键安装脚本，脚本会自动检测并更新到最新版本。
通过本教程，您已经成功在本地部署了Codex中文版。现在，尽情享受AI编程带来的高效体验吧！