跳到主要内容
返回文档
快速入门

42cc 快速入门

5 分钟配置 Claude Code 或 Codex

42cc 是一个本地运行的 Coding CLI 配置管理工具。你先选择要配置的 CLI,再选择供应商和认证方式。 保存只是把配置放进 42cc,点击「使用」才会写入目标 CLI。

一、快速安装

macOS 和 Windows 都推荐使用一键安装脚本:

curl -fsSL https://get.42plugin.com/42cc | bash

Windows 用户请在支持 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 CodeAnthropic 官方、Anthropic 兼容第三方、本地 Anthropic 兼容服务~/.claude/settings.json
CodexChatGPT / Codex 登录、OpenAI 官方、OpenAI 兼容第三方、本地 OpenAI 兼容服务~/.codex/auth.json + ~/.codex/config.toml

42cc 会分别记录 Claude Code 和 Codex 当前使用的配置。

四、快速配置 Claude Code

以下以智谱 GLM 为例,其他 Anthropic 兼容第三方供应商流程相同。

  1. 打开配置窗口:点击托盘图标,选择「配置」。
  2. 点击「新增配置」,或按 Cmd+N / Ctrl+N
  3. 「用于」选择 Claude Code
  4. 供应商选择「智谱 GLM」,名称填写自定义名称,API 密钥填写你的智谱 API Key。
  5. 模型别名使用默认值或按需修改。
  6. 点击「保存」把配置保存到 42cc。
  7. 在配置列表选中它,点击「使用」或按 Enter,42cc 会写入 Claude Code 配置。
常见 Claude Code 供应商关键字段
AnthropicClaude 订阅、Anthropic API Key 或 OAuth Token
MiniMax / 智谱 GLM / DeepSeek / Kimi / 阿里 QwenAPI Key,模型别名
Ollama / LM StudioBase URL,默认模型,模型别名
其他第三方 APIBase URL,API Key,模型别名

五、快速配置 Codex

方式 1:ChatGPT / Codex 登录

适合已有 ChatGPT Plus / Pro / Team 或 Codex 登录态的用户。

  1. 点击「新增配置」。
  2. 「用于」选择 Codex,供应商选择 OpenAI
  3. 认证方式选择 ChatGPT / Codex 登录
  4. 如果 42cc 检测到当前 ~/.codex/auth.json 中已有可用登录,点击「使用当前登录」。
  5. 如果尚未登录,点击「登录 Codex 账号」,在浏览器中完成登录后回到 42cc。
  6. 可点击「重新检测」刷新登录状态。
  7. 点击「保存」,再点击「使用」写入 Codex 配置,使用时重启 Codex 生效。

42cc 不实现内嵌 OAuth,也不负责 token 刷新;Codex 登录态由 Codex CLI 管理。42cc 负责绑定当前登录、保存账号快照,并在切换时写回 ~/.codex/auth.json

方式 2:OpenAI API Key 或 OpenAI 兼容服务

  1. 「用于」选择 Codex
  2. 选择 OpenAI 或 OpenAI 兼容供应商,如 MiniMax、智谱 GLM、DeepSeek、Kimi、阿里 Qwen。
  3. 填写 API Key。
  4. 填写或保留默认模型。
  5. 点击「保存」,再在配置列表中点击「使用」。

42cc 会写入 ~/.codex/auth.json~/.codex/config.toml

Codex 本地服务Base URL
Ollamahttp://localhost:11434/v1
LM Studiohttp://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使用选中的配置,或保存表单