U-Codex Mac 版
U-Codex 商业便携版 · 操作指南
Apple Silicon 专用 | 即插即用 | 终端控制台
版本 v2.1.0.9 | 支持 M1/M2/M3/M4
📑 本文目录
📦 产品概述
产品特点
- 🔌 即插即用 — U 盘一插，双击运行，无需安装
- 🍎 Mac 原生 — 专为 Apple Silicon 优化，纯终端控制台
- 🌐 国内直连 — 接入硅基流动等国内大模型，无需代理
- 🇨🇳 完美汉化 — 全界面中文翻译，操作直观
- 🔄 换机无忧 — 配置随 U 盘携带，换电脑不丢失
- ⚡ 全自动引导 — 首次运行自动检测并安装 Homebrew 和必需应用
⚙️ 系统要求与准备
⚠️ 重要提醒
• 本版本仅支持 Apple Silicon 芯片（M1/M2/M3/M4 系列）
• Intel 芯片 Mac 无法使用
• 系统要求：macOS 12 Monterey 或更高版本
• U 盘要求：USB 3.0 或 3.2，16GB 以上空间
• 本版本仅支持 Apple Silicon 芯片（M1/M2/M3/M4 系列）
• Intel 芯片 Mac 无法使用
• 系统要求：macOS 12 Monterey 或更高版本
• U 盘要求：USB 3.0 或 3.2，16GB 以上空间
💡 U 盘目录结构
U-Codex/
├── U-Codex控制台.command # 主菜单（双击运行）
├── modules/ # 功能模块
├── profile/.codex/ # 配置目录（授权、API Key、会话）
├── Codex-MacOS安装器.dmg # Codex 安装器（备用）
└── cc-switch/
└── CC-Switch-v3.16.1-macOS.dmg # CC-Switch 安装器（备用）🚀 首次使用（全自动引导）
操作步骤
- 插入 U 盘，双击
U-Codex-Mac控制台.command - 程序自动检测并引导安装 Homebrew（如未安装）
- 自动检测并引导安装 Codex.app 和 CC-Switch.app（如未安装）
- 输入激活码完成授权
- 进入主菜单，开始使用
💡 首次运行流程图
插入U盘 → 双击控制台 → 检测Homebrew → 检测应用 → 激活授权 → 进入主菜单
插入U盘 → 双击控制台 → 检测Homebrew → 检测应用 → 激活授权 → 进入主菜单
🎮 控制台功能详解
主菜单界面
========================================
U-Codex - Portable AI Agent
DaNiu AI Intelligent Technology
大牛AI智能科技(开发维护)
========================================
商业便携版控制台 V2.1.0.9
架构: Apple Silicon (M1/M2/M3/M4)
========================================
[1] 一键汉化
[2] 启动 Codex 主程序
[3] Codex 配置管理
[4] 大模型配置接入（CC-Switch）
[5] 清理进程和服务
[6] 一键重启服务
[7] 一键更新最新版
[8] 安全退出 U 盘
[Q] 退出
========================================功能对照表
| 按键 | 功能名称 | 说明 |
|---|---|---|
| 1 | 一键汉化 | 自动打开教程和 Karing 代理，切换中文界面 |
| 2 | 启动 Codex | 自动启动 CC-Switch 和 Codex |
| 3 | 配置管理 | 查看/编辑 config.toml 和 .env |
| 4 | 大模型接入 | 启动 CC-Switch 并打开配置教程 |
| 5 | 清理进程 | 结束 Codex、CC-Switch、node 进程 |
| 6 | 重启服务 | 清理后自动重启所有服务 |
| 7 | 一键更新 | 通过 Homebrew 更新 Codex |
| 8 | 安全退出 | 清理进程后关闭控制台 |
| Q | 退出 | 直接退出控制台 |
🔐 激活授权
操作步骤
- 首次运行自动进入激活界面
- 输入购买时获得的激活码
- 系统自动获取设备标识
- 云端验证通过后自动激活
- 激活成功后进入主菜单
⚠️ 注意事项
• 每个激活码激活后一次性作废，按授权协议激活，复制无需
• 更换 U 盘或电脑后可能需要重新激活
• 首次激活，后续永久使用
• 每个激活码激活后一次性作废，按授权协议激活，复制无需
• 更换 U 盘或电脑后可能需要重新激活
• 首次激活，后续永久使用
🌐 一键汉化
操作步骤：
- 📖 详细汉化图文教程：🔗https://www.daniu-ai.com/doc/255/
- 主菜单输入 1 回车
- 自动打开汉化教程页面和 Karing 代理
- 按教程配置代理并连接
- 代理连接成功后，自动启动 Codex
- 在 Codex 设置中切换语言：
English → 完全退出 → Chinese → 完全退出 - 重新启动 Codex，界面变为中文
💡 温馨提示
• 语言包下载一次后会缓存，后续使用无需代理
• 换电脑后如界面变英文，重复上述步骤即可
• 语言包下载一次后会缓存，后续使用无需代理
• 换电脑后如界面变英文，重复上述步骤即可
⚙️ 大模型配置接入
操作步骤：
- ⚙️ 大模型接入详细图文教程：https://www.daniu-ai.com/doc/296/
- 主菜单输入 4 回车
- 自动启动 CC-Switch 并打开配置教程
- 在 CC-Switch 中：
- 切换到「Codex」标签页
- 点击「+」添加供应商，选择「SiliconFlow」
- 填入 API Key 和 Base URL
- 设置模型映射：
gpt-5.5→Qwen/Qwen2.5-7B-Instruct - 开启本地路由（两个开关）
- 启用供应商
- 配置完成后重启 Codex
💡 API Key 获取方式
访问
访问
https://siliconflow.cn → 注册/登录 → 控制台 → API 密钥 → 创建新密钥📝 配置文件管理
配置文件位置
U-Codex/profile/.codex/config.toml # 主配置文件
U-Codex/profile/.codex/.env # API Key 配置通过控制台管理
- 主菜单输入 3 回车
- 选择查看、编辑或重置配置
- 修改后重启 Codex 生效
🔄 一键更新
操作步骤
- 主菜单输入 7 回车
- 自动检测最新版本
- 有新版本时确认更新
- 通过 Homebrew 自动更新 Codex
- 更新完成后可选择重启
❓ 常见问题解答
Q1 首次运行提示「无法打开，因为无法验证开发者」？
➜ 右键点击应用 → 选择「打开」→ 点击「打开」确认。或前往「系统设置」→「隐私与安全性」→ 允许运行。
Q2 激活码无效怎么办？
➜ 检查激活码是否正确，确认网络畅通，联系客服获取有效激活码。
Q3 Homebrew 安装失败怎么办？
➜ 检查网络连接，尝试切换镜像源。或手动安装：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
Q4 Codex 一直「思考」不回复？
➜ 检查 CC-Switch 是否在后台运行，检查日志面板是否有红色错误，确认模型映射正确。
Q5 换电脑后配置丢失？
➜ 配置存储在 U 盘，但 CC-Switch 的配置保存在 ~/.cc-switch，换电脑后需重新配置一次。
Q6 如何卸载？
➜ Codex：brew uninstall --cask codex
➜ CC-Switch：brew uninstall --cask cc-switch
➜ 删除 U 盘 U-Codex 文件夹即可
📞 技术支持
- 🌐 官网：https://www.daniu-ai.com
- 📖 汉化教程：https://www.daniu-ai.com/doc/255/
- ⚙️ 大模型接入教程：https://www.daniu-ai.com/doc/296/
🎉 恭喜！你已经完成了 U-Codex Mac 版的全部配置！
现在可以愉快地使用中文版 AI 编程助手了！