下载客户端
Windows 先下载安装包；macOS / Linux 使用已安装的桌面版或 CLI。
查看下载文件Conpera 内部版 · Codex 客户端
Conpera Codex 安装配置 API Key 分配与使用说明
这份说明面向第一次安装的同事。按顺序完成安装包、配置文件和 API Key 三步， 就可以打开 Codex 开始处理排程、代码和文档任务。
Quick Start
新用户只做这 4 步
放配置文件
下载通用 config.toml，放进本机 .codex 目录。
生成 auth.json
粘贴管理员分配的 API Key，页面会在本地生成 auth.json 并下载。
验证可用
重启 Codex，发送一句测试消息，确认模型可以正常回复。
查看验证方式Simple Setup
安装配置简易版
按系统放置下载文件
config.toml 是通用配置文件，Windows 和 macOS / Linux 共用同一个版本。
Windows 放置步骤
配置目录
%USERPROFILE%\.codex
- 运行 Codex+Installer.exe，按默认选项完成安装。
- 打开资源管理器，在地址栏输入
%USERPROFILE%\.codex。 - 把 config.toml 放进这个目录。
- 在下方粘贴管理员给你的 API Key，下载 auth.json，同样放在这个目录。
macOS / Linux 放置步骤
配置目录
~/.codex
- 安装 Codex CLI，或使用已安装的 Codex 桌面版。
- 打开终端，确认目录存在：
mkdir -p ~/.codex。 - 下载到本机的配置文件保持文件名为 config.toml，放进
~/.codex。 - 在下方粘贴管理员给你的 API Key，下载 auth.json，同样放进
~/.codex。
API Key
输入 API Key，下载 auth.json
一人一个 key
管理员为每个人生成独立 API Key。你只需要把自己的 key 粘贴到右侧， 页面会在浏览器本地写入文件，不上传、不保存。
- 只使用管理员分配给你的 key
- 离职、换岗或泄露后立即停用
- 不要把 key 或 auth.json 发到群聊、截图或文档里
本地生成 auth.json
粘贴 API Key 后点击下载，文件名固定为 auth.json，放进 .codex 目录即可。
管理员口径：
分配 key 时只需要告诉用户三件事：key 本身、放置目录、出现认证失败时联系谁处理。
页面只在本地生成文件，不会把 key 发送到服务器。
Verify
安装后验证
桌面版
重启 Codex，在任意项目目录打开对话，发送：
测试消息
请回复一句：Conpera Codex 已连接成功。
CLI 版
安装 CLI 后，在终端运行：
终端命令
codex exec --skip-git-repo-check "say Conpera Codex ready"
Usage Guide
使用说明文档
选择工作目录
先打开要处理的项目文件夹，再让 Codex 分析、修改或运行命令。
清楚说明目标
描述要改什么、验收标准是什么、是否允许提交或部署。
让 Codex 先验证
涉及代码和配置变更时，要求它运行测试、构建或页面预览。
敏感信息不进聊天
API Key、数据库密码和客户数据只放本机配置文件，不粘贴到公开对话。
推荐开场语
把任务边界说清楚，Codex 的执行会稳定很多。
可复制
请先阅读当前项目结构，给出你要修改的文件和验证方式；确认后直接实现，并在最后说明改了什么、如何验证。
FAQ
常见问题
提示认证失败怎么办？
确认 auth.json 文件名没有后缀错误，且已放到 .codex 目录。仍失败时联系管理员换发 key。
提示 model 不存在怎么办？
确认 config.toml 已放到正确目录，并重启 Codex。仍失败时联系管理员确认客户端版本和账号权限。
CLI 命令不可用怎么办？
先完成 CLI 安装说明。Windows 上通常需要安装 Node.js LTS 并重新打开命令提示符。
可以把配置文件发给别人吗？
config.toml 可以统一分发，auth.json 不可以。每个人只能使用自己的 API Key。