环境初始化
下载并运行 Windows 安装程序，或配置 macOS / Linux 运行环境。
Quick Start
部署流程预览
全局配置导入
将通用的 config.toml 部署至本地 .codex 预设目录。
身份认证鉴权
使用企业分配的 API Key 在本地生成加密的 auth.json 凭证文件。
连通性验证
通过桌面端或 CLI 运行标准测试指令，确认模型响应状态。
Step 01 & 02
安装程序与配置文件
跨平台部署说明
请根据您的操作系统选择对应的安装路径。config.toml 为跨平台通用文件。
配置路径
Target Directory
%USERPROFILE%\.codex
- 运行
Codex+Installer.exe完成安装。 - 打开资源管理器，进入
%USERPROFILE%\.codex目录。 - 将
config.toml放入该目录。 - 在下方生成
auth.json并同样放入该目录。
终端配置
Config Directory
~/.codex
- 部署 Codex 桌面版或 CLI 工具。
- 执行：
mkdir -p ~/.codex。 - 将
config.toml与生成的auth.json放入该目录。
Step 03
生成 auth.json 身份凭证
安全合规说明
API Key 是您的唯一身份标识。凭证生成过程完全在浏览器本地完成，不经过任何服务器传输。
- 凭证仅限本人在授权终端使用。
- 严禁在公开文档、代码仓库或即时通讯工具中泄露。
- 如遇安全风险，请立即联系管理员重置 Key。
本地凭证生成
请输入管理员分配的 API Key，系统将自动生成 auth.json 文件。
管理员提示：
分配 Key 时请同步告知用户配置目录位置。
auth.json 必须与 config.toml 处于同一目录下。
Step 04
连通性验证
桌面端验证
重启客户端，开启新对话并发送测试指令：
Test Message
请回复一句：Conpera Codex 已连接成功。
CLI 验证
在终端运行以下命令确认环境就绪：
CLI Command
codex exec --skip-git-repo-check "say Conpera Codex ready"
Best Practices
使用规范
工作目录规范
始终在具体的项目上下文中启动对话，以便 Codex 能够准确索引代码结构与资源。
指令意图对齐
明确任务目标、边界条件与技术栈要求。推荐使用“先规划、后实现”的互动模式。
闭环验证机制
利用 Codex 的执行能力，要求其在完成修改后运行构建脚本或单元测试。
数据脱敏原则
机密数据（如生产数据库密钥）应通过配置文件读取，避免直接在聊天记录中传播。
推荐初始化指令
建立标准化的互动协议，提升协作效率。
Standard Prompt
请分析当前工程结构，列出待修改文件清单；确认后开始执行，并在完成后说明验证步骤。
FAQ
常见问题
认证失败 (Authentication Failed)
请核对 auth.json 文件命名是否正确（注意后缀名），并确认其已放置在 .codex 根目录下。如持续失败，请联系管理员核对 Key 有效性。
模型无响应 (Model Not Found)
通常由于 config.toml 未被正确索引或 API 限额耗尽。请重启客户端并检查配置文件路径。
CLI 命令未找到
请确保已完成 Node.js LTS 环境安装，并正确配置了系统环境变量。详见 CLI 安装指南。
配置文件能否发给别人？
config.toml 包含通用的模型路由信息，可以分享；但 auth.json 包含您的个人 API Key 凭证，绝对禁止分享给他人。