42cc 是一个本地运行的 Coding CLI 配置管理工具。你先选择要配置的 CLI,再选择供应商和认证方式。 保存只是把配置放进 42cc,点击「使用」才会写入目标 CLI。
一、快速安装
macOS 和 Windows 都推荐使用一键安装脚本:
curl -fsSL https://get.42plugin.com/42cc | bashWindows 用户请在支持 bash 的终端中运行,例如 Git Bash 或其他 bash 环境。安装完成后可以直接执行 42cc 启动。
备选方式
# bun
bun add -g @42ailab/42cc
# npm
npm install -g @42ailab/42cc
# Homebrew(macOS)
brew tap 42ailab/42cc
brew install --cask 42cc也可以访问 42cc 官网 下载安装包:macOS 下载 DMG,Windows 下载 exe。
二、启动应用
通过一键脚本或包管理器安装后,在终端中执行:
42cc直接下载安装包时,macOS 双击应用程序文件夹中的 42cc,Windows 双击 42cc.exe。
应用会常驻系统托盘:macOS 在菜单栏,Windows 在系统托盘。
三、选择目标 CLI
新增配置时,先看「用于」字段。
| 目标 CLI | 适合什么场景 | 写入位置 |
|---|---|---|
| Claude Code | Anthropic 官方、Anthropic 兼容第三方、本地 Anthropic 兼容服务 | ~/.claude/settings.json |
| Codex | ChatGPT / Codex 登录、OpenAI 官方、OpenAI 兼容第三方、本地 OpenAI 兼容服务 | ~/.codex/auth.json + ~/.codex/config.toml |
42cc 会分别记录 Claude Code 和 Codex 当前使用的配置。
四、快速配置 Claude Code
以下以智谱 GLM 为例,其他 Anthropic 兼容第三方供应商流程相同。
- 打开配置窗口:点击托盘图标,选择「配置」。
- 点击「新增配置」,或按
Cmd+N/Ctrl+N。 - 「用于」选择
Claude Code。 - 供应商选择「智谱 GLM」,名称填写自定义名称,API 密钥填写你的智谱 API Key。
- 模型别名使用默认值或按需修改。
- 点击「保存」把配置保存到 42cc。
- 在配置列表选中它,点击「使用」或按
Enter,42cc 会写入 Claude Code 配置。
| 常见 Claude Code 供应商 | 关键字段 |
|---|---|
| Anthropic | Claude 订阅、Anthropic API Key 或 OAuth Token |
| MiniMax / 智谱 GLM / DeepSeek / Kimi / 阿里 Qwen | API Key,模型别名 |
| Ollama / LM Studio | Base URL,默认模型,模型别名 |
| 其他第三方 API | Base URL,API Key,模型别名 |
五、快速配置 Codex
方式 1:ChatGPT / Codex 登录
适合已有 ChatGPT Plus / Pro / Team 或 Codex 登录态的用户。
- 点击「新增配置」。
- 「用于」选择
Codex,供应商选择OpenAI。 - 认证方式选择
ChatGPT / Codex 登录。 - 如果 42cc 检测到当前
~/.codex/auth.json中已有可用登录,点击「使用当前登录」。 - 如果尚未登录,点击「登录 Codex 账号」,在浏览器中完成登录后回到 42cc。
- 可点击「重新检测」刷新登录状态。
- 点击「保存」,再点击「使用」写入 Codex 配置,使用时重启 Codex 生效。
42cc 不实现内嵌 OAuth,也不负责 token 刷新;Codex 登录态由 Codex CLI 管理。42cc 负责绑定当前登录、保存账号快照,并在切换时写回 ~/.codex/auth.json。
方式 2:OpenAI API Key 或 OpenAI 兼容服务
- 「用于」选择
Codex。 - 选择
OpenAI或 OpenAI 兼容供应商,如 MiniMax、智谱 GLM、DeepSeek、Kimi、阿里 Qwen。 - 填写 API Key。
- 填写或保留默认模型。
- 点击「保存」,再在配置列表中点击「使用」。
42cc 会写入 ~/.codex/auth.json 和 ~/.codex/config.toml。
| Codex 本地服务 | Base URL |
|---|---|
| Ollama | http://localhost:11434/v1 |
| LM Studio | http://localhost:1234/v1/responses |
六、切换配置
托盘菜单适合快速切换:点击托盘图标,在配置列表中点击要切换的配置。
管理窗口适合查看详情后切换:打开「配置」,使用方向键或 Tab 选择配置,按 Enter 或点击「使用」。
Claude Code 与 Codex 会各自显示当前正在使用的配置。
七、测试配置
测试入口有三个:新增/编辑配置窗口、配置详情页、托盘菜单。测试是可选的,失败不阻断保存和使用。
| 配置类型 | 是否可测试 | 说明 |
|---|---|---|
| Claude Code API Key / Anthropic 兼容第三方 | 可测试 | 发送 Anthropic Messages API 检查 |
| Codex API Key / OpenAI 兼容第三方 | 可测试 | 请求 /v1/models 检查 |
| Ollama / LM Studio | 可测试 | 需要本地服务已启动并选择默认模型 |
| Claude 订阅 / Claude OAuth Token | 不可直接测试 | 登录态由 Claude Code 管理 |
| ChatGPT / Codex 登录 | 不可直接测试 | 登录态由 Codex CLI 管理 |
八、重启规则
| 目标 CLI | 需要重启的情况 |
|---|---|
| Claude Code | 官方配置与第三方配置之间切换、订阅模式切入切出、Ollama / LM Studio 与其他配置切换、模型别名变化 |
| Codex | 切换 Codex 登录账号、切换 OpenAI 兼容 provider、默认模型或 Base URL 变化 |
九、常用快捷键
| 快捷键 | 功能 |
|---|---|
Cmd+N / Ctrl+N | 新增配置 |
Cmd+E / Ctrl+E | 编辑选中的配置 |
Cmd+C / Ctrl+C | 复制配置 |
Cmd+V / Ctrl+V | 粘贴配置 |
Enter | 使用选中的配置,或保存表单 |