跳到主要内容
返回文档
完整教程

42cc 完整使用教程

Claude Code 与 Codex 配置管理完整指南

目录

安装指南

推荐方式：一键安装脚本

macOS 和 Windows 都推荐使用同一条命令安装：

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

Windows 用户请在支持 bash 的终端中运行，例如 Git Bash 或其他 bash 环境。安装完成后可以直接执行 42cc 启动。

备选方式

# bun（macOS / Windows）
bun add -g @42ailab/42cc

# npm（macOS / Windows）
npm install -g @42ailab/42cc

# Homebrew（macOS）
brew tap 42ailab/42cc
brew install --cask 42cc

也可以访问 42cc 官网 下载安装包：macOS 下载 DMG，Windows 下载 exe。

开机自启动

macOS：点击菜单栏 42cc 图标，选择「关于 42cc」，勾选「开机自启」。

Windows：点击系统托盘 42cc 图标，勾选「开机自启」。

基础使用

启动应用

通过一键脚本或包管理器安装后执行：

42cc

直接下载时，双击应用程序或 exe 文件。启动后 42cc 会常驻系统托盘。

选择目标 CLI 与供应商

新增配置时先选择「用于」。这个选择决定后续表单字段、诊断方式和最终写入哪个 CLI。

目标 CLI协议可选供应商
Claude CodeAnthropic 兼容Anthropic、MiniMax、智谱 GLM、DeepSeek、Kimi、阿里 Qwen、Ollama、LM Studio、其他第三方 API
CodexOpenAI 兼容OpenAI、MiniMax、智谱 GLM、DeepSeek、Kimi、阿里 Qwen、Ollama、LM Studio、其他第三方 API
目标 CLI写入位置
Claude Code~/.claude/settings.json
Codex~/.codex/auth.json、~/.codex/config.toml

保存与使用的区别

操作效果
保存仅保存到 42cc 的配置列表
使用将配置写入目标 CLI，并设为当前使用
保存并使用保存后立即写入目标 CLI

如果编辑的是当前正在使用的配置，保存后 42cc 会同步更新对应 CLI 的配置文件。

切换配置

托盘菜单适合快速切换：点击 42cc 图标，在配置列表中点击目标配置。

管理窗口适合查看详情后切换：打开「配置」，选择配置后点击「使用」，或按 Enter。

Claude Code 与 Codex 各自有当前配置。Anthropic 兼容配置默认直连 Claude Code，OpenAI 兼容配置默认直连 Codex。

测试配置

测试入口包括新增/编辑配置窗口、配置详情页面和托盘菜单。

配置类型是否可测试诊断方式
Claude Code API Key / Anthropic 兼容第三方可测试Anthropic Messages API
Codex API Key / OpenAI 兼容第三方可测试OpenAI 兼容 /v1/models
Ollama / LM Studio可测试本地模型列表与 API 响应
Claude 订阅 / Claude OAuth Token不可直接测试登录态由 Claude Code 管理
ChatGPT / Codex 登录不可直接测试登录态由 Codex CLI 管理

测试完全可选。测试失败不阻断保存和使用。

Claude Code 使用指南

Claude 订阅

  1. 新增配置。
  2. 「用于」选择 Claude Code。
  3. 供应商选择 Anthropic。
  4. 认证方式选择 Claude 订阅（Pro / Max）。
  5. 保存并使用。
  6. 在 Claude Code 中执行 /login，或在终端执行 claude login。
  7. 重启 Claude Code。

切换到其他配置前，先在 Claude Code 中执行 /logout，再执行 /exit。

Anthropic API Key

  1. 访问 Anthropic Console 创建 API Key。
  2. 新增配置，「用于」选择 Claude Code。
  3. 供应商选择 Anthropic，认证方式选择 Anthropic API Key。
  4. 填写 API Key，可选填写默认模型。
  5. 保存并使用。

Anthropic 兼容第三方

供应商说明
MiniMax国内版 / 国际版
智谱 GLM默认模型 glm-4.7
DeepSeek默认模型 deepseek-chat
Kimi默认模型 kimi-k2.5
阿里 Qwen默认模型 qwen3.5-plus，写入时自动小写
  1. 新增配置，「用于」选择 Claude Code。
  2. 选择供应商。
  3. 填写 API Key。
  4. 检查模型别名：Opus、Sonnet、Haiku。
  5. 可选测试连接。
  6. 保存并使用。

模型别名用于把 Claude Code 的模型档位映射到第三方实际模型 ID。第三方品牌会预填默认值，通常可以直接使用。

Claude Code 本地模型

Ollama

  1. 安装并启动 Ollama。
  2. 下载模型，例如 ollama pull qwen2.5-coder。
  3. 新增配置，「用于」选择 Claude Code，供应商选择 Ollama。
  4. Base URL 默认 http://localhost:11434。
  5. 选择默认模型并填写模型别名。
  6. 保存并使用。

LM Studio

  1. 安装 LM Studio，下载并加载模型，启动本地服务。
  2. 新增配置，「用于」选择 Claude Code，供应商选择 LM Studio。
  3. Base URL 默认 http://localhost:1234。
  4. 选择默认模型并填写模型别名。
  5. 保存并使用。

Claude Code 自定义 API

  1. 新增配置，「用于」选择 Claude Code。
  2. 供应商选择「其他第三方 API」。
  3. 填写 Base URL、API Key 和模型别名。
  4. 保存并使用。

自定义 Base URL 按用户填写值使用，42cc 不会自动补全路径。

Codex 使用指南

ChatGPT / Codex 登录

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

  1. 新增配置。
  2. 「用于」选择 Codex。
  3. 供应商选择 OpenAI。
  4. 认证方式选择 ChatGPT / Codex 登录。
  5. 如果检测到当前登录，点击「使用当前登录」。
  6. 如果未登录，点击「登录 Codex 账号」，浏览器完成登录后回到 42cc。
  7. 可点击「重新检测」刷新状态。
  8. 保存并使用。
  9. 重启 Codex。
文件作用
~/.codex/auth.jsonCodex 当前工作登录态
~/.codex/config.tomlCodex 模型与 provider 配置
~/.42cc/sessions/{session_id}.json42cc 保存的 Codex 账号快照

42cc 会确保 Codex 使用 auth.json 作为凭据存储。若当前是 keyring、auto 或 ephemeral 模式，登录/切换时会尝试改为 file 模式，以便管理多个账号。

42cc 不实现 Codex token 刷新；刷新由 Codex CLI 负责。42cc 只负责绑定、快照、切换和写入当前工作副本。

OpenAI API Key

  1. 新增配置。
  2. 「用于」选择 Codex。
  3. 供应商选择 OpenAI。
  4. 认证方式选择 OpenAI API Key。
  5. 填写 API Key。
  6. 默认模型可留空跟随 Codex 默认，也可填写目标模型。
  7. 保存并使用。

OpenAI 兼容第三方

供应商默认模型默认 Base URL
MiniMaxMiniMax-M2.5https://api.minimaxi.com/v1
智谱 GLMglm-4.7https://open.bigmodel.cn/api/coding/paas/v4
DeepSeekdeepseek-chathttps://api.deepseek.com
Kimikimi-k2.5https://api.moonshot.cn/v1
阿里 Qwenqwen3.5-plushttps://coding.dashscope.aliyuncs.com/v1
  1. 新增配置，「用于」选择 Codex。
  2. 选择 OpenAI 兼容供应商。
  3. 填写 API Key。
  4. 填写默认模型。第三方品牌会预填默认值。
  5. 可选测试连接。
  6. 保存并使用。

42cc 会生成 Codex custom provider 配置，并使用 wire_api = "responses"。

Codex 本地模型

Ollama

  1. 安装并启动 Ollama。
  2. 新增配置，「用于」选择 Codex，供应商选择 Ollama。
  3. Base URL 默认 http://localhost:11434/v1。
  4. 选择默认模型。
  5. 保存并使用。

LM Studio

  1. 安装 LM Studio，加载模型并启动本地服务。
  2. 新增配置，「用于」选择 Codex，供应商选择 LM Studio。
  3. Base URL 默认 http://localhost:1234/v1/responses。
  4. 选择默认模型。
  5. 保存并使用。

Codex 本地模型不需要 OpenAI API Key。42cc 会在 Codex 配置中设置 requires_openai_auth = false。

Codex 自定义 API

  1. 新增配置，「用于」选择 Codex。
  2. 供应商选择「其他第三方 API」。
  3. 填写 Base URL、API Key 和默认模型。
  4. 保存并使用。

自定义 Base URL 按用户填写值使用，42cc 不会自动追加 /v1/models 或 /responses。

模型别名与默认模型

Claude Code 和 Codex 的模型字段语义不同。

目标 CLI字段作用
Claude Code模型别名 Opus / Sonnet / Haiku把 Claude Code 的档位映射到实际模型 ID
Claude Code默认模型写入 Claude Code 的 model 字段，可留空跟随 Claude Code 默认
Codex默认模型写入 Codex 的 model 字段；订阅登录可留空跟随 Codex 默认

配置复制与粘贴

在配置列表中选择配置后，可以使用 Cmd+C / Ctrl+C 复制，使用 Cmd+V / Ctrl+V 粘贴。

复制内容会包含 provider、Base URL、默认模型或模型别名、认证类型等字段。粘贴时 42cc 会按当前 schema 解析并补齐必要结构。

配置文件与隐私

文件说明
~/.42cc/profiles.toml42cc 保存的配置列表，包含 API Key，文件权限限制为当前用户读写
~/.claude/settings.jsonClaude Code 当前工作配置
~/.codex/auth.jsonCodex 当前工作凭据
~/.codex/config.tomlCodex 当前 provider 与模型配置
~/.42cc/sessions/Codex 登录账号快照

42cc 本地运行，不把 API Key 或登录态上传到 42cc 服务器。测试连接会直接访问所选 provider。

常见问题

为什么保存后目标 CLI 没有变化？

「保存」只保存到 42cc。需要点击「使用」或「保存并使用」，才会写入 Claude Code 或 Codex。

Codex 登录配置为什么不能直接测试？

ChatGPT / Codex 登录态由 Codex CLI 管理，42cc 只能检测、绑定和切换本地登录态，不代替 Codex CLI 验证订阅权限。

切换配置后是否需要重启？

Claude Code 官方配置与第三方配置之间切换、订阅模式切入切出、本地模型切换、模型别名变化时，建议重启 Claude Code。

Codex 切换登录账号、OpenAI 兼容 provider、默认模型或 Base URL 后，建议重启 Codex。

自定义 Base URL 会被自动补全吗？

不会。其他第三方 API 配置中，用户填什么，42cc 就写什么。

快速入门常见问题