Codex 桌面版使用教程
从下载安装到第一个任务，把码头的模型接入你的桌面工作流。
下载并安装 Codex
从 Codex 官方页面 ↗ 获取适合你电脑的桌面版，按下载页说明安装。系统要求和可用安装包以官方页面为准。
桌面版和命令行版是不同入口。仅使用桌面版时，不需要为了本教程额外安装 Node.js 或 Codex CLI。
将码头配置应用到 Codex
准备一枚 OpenAI 分组的码头密钥。先完全退出 Codex，再选择下面一种方式。
方式 A · CC Switch
按照 CC Switch 配置步骤，切换到 Codex，添加并启用码头供应商。API 地址填写 https://matouapi.com/v1，选择 Responses 协议与分组支持的模型。
方式 B · 手动配置
在 Finder 按 ⌘ Shift G，输入 ~/.codex 并前往。
按 Win + R，输入 %USERPROFILE%\.codex 并回车。
找不到目录时，在用户主目录新建 .codex 文件夹。用纯文本编辑器编辑文件，注意不要保存成 .txt。
先备份已有 config.toml。优先复制控制台「使用密钥 → Codex」为当前密钥生成的配置；如显示认证模式，按所用版本的提示选择。
以下为自定义供应商的最小示例。把模型占位符改为当前分组支持的模型 ID，把密钥占位符改为自己的密钥；不要原样使用占位符。
model_provider = "matou"
model = "替换为分组支持的模型ID"
[model_providers.matou]
name = "码头中转站"
base_url = "https://matouapi.com/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "替换为你的码头_API_KEY"控制台给了 auth.json，该怎么处理？
部分兼容配置会使用 requires_openai_auth = true 和 auth.json。这是一套不同的认证方式，请完整使用控制台提供的那套文件，不要与上面的直接 Bearer 密钥方式混搭。替换前备份已有文件，可能影响原登录状态；本机曾用系统凭据库保存登录时，还需按客户端的认证提示处理。
桌面应用版本更新可能影响第三方供应商的识别。若控制台另有模型目录文件或版本兼容提示，也要按提示完成；本页配置未代替所有版本的实际连接验收。
重启应用，开始第一个任务
- 完全退出并重新打开 Codex，让它重新读取配置。如果仍停留在登录页，核对所用版本、用户配置目录与认证模式，不要反复更换密钥。
- 添加一个你愿意让 Codex 读取的项目文件夹。第一次使用可以新建一个空文件夹。
- 新建任务，确认使用的模型与码头分组兼容，输入下面的测试请求。
请只回复“连接成功”，不要读取或修改任何文件。收到回答后，去码头控制台核对用量记录。确认连接正常，再开始真正的工作。
先阅读项目结构，告诉我它的用途，并给出修改计划。
阅读 → 提出方案 → 确认范围 → 执行与检查
让日常使用更顺手
- 说清目标：描述要实现的结果、涉及的文件和不能改动的范围。
- 先看方案：复杂任务先让 Codex 分析并给出计划。
- 检查改动：查看文件差异与运行结果，再决定是否采用。
- 关注用量：长对话、大项目和复杂任务可能消耗更多 token；按需要新建任务并设置密钥限额。
配置 API 中转不代表同时获得所有 ChatGPT 账号功能。涉及云端任务、连接器等能力时，按应用当前提供的登录与权限说明使用。