42cc 快速入门

一、快速安装

选择最适合你的安装方式：

macOS 用户

方式 1：直接下载（推荐）— 访问 https://get.42plugin.com/42cc.dmg，双击打开后拖拽到应用程序文件夹，双击即用

方式 2：终端一键安装

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

方式 3：bun

bun add -g @42ailab/42cc

方式 4：Homebrew

brew tap 42ailab/42cc
brew install --cask 42cc

Windows 用户

方式 1：直接下载（推荐）— 访问 https://get.42plugin.com/42cc.exe，双击打开即可运行

方式 2：bun

bun add -g @42ailab/42cc

二、启动应用

根据你的安装方式选择对应的启动方法：

直接下载安装（dmg/exe）

• macOS：打开应用程序文件夹，双击 42cc 图标启动
• Windows：双击下载的 42cc.exe 文件启动

使用包管理器安装（bun/Homebrew）

在终端中执行：

42cc

应用将以系统托盘形式运行（macOS 在菜单栏，Windows 在系统托盘）。

三、添加配置

配置智谱 GLM

1. 打开配置窗口
   • 点击托盘图标
   • 选择"配置"
2. 新增配置
   • 点击"新增配置"按钮（或按 Cmd+N / Ctrl+N）
   • 填写配置信息：
     • 名称：智谱清言（自定义名称）
     • 供应商：选择"智谱 GLM"
     • API 密钥：输入你的智谱 API Key
3. 保存配置
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置阿里 Qwen

1. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：阿里 Qwen（自定义名称）
     • 供应商：选择"阿里 Qwen"
     • API 密钥：输入你的 DashScope API Key
2. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置 MiniMax

1. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：MiniMax（自定义名称）
     • 供应商：选择"MiniMax"
     • 版本：国内版 / 国际版（自动配置对应 Base URL）
     • API 密钥：输入你的 MiniMax API Key
2. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置 DeepSeek

1. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：DeepSeek（自定义名称）
     • 供应商：选择"DeepSeek"
     • API 密钥：输入你的 DeepSeek API Key
2. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置 Kimi

1. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：Kimi（自定义名称）
     • 供应商：选择"Kimi"
     • 版本：国内版（api.moonshot.cn）/ 国际版（api.moonshot.ai）
     • API 密钥：输入你的 Moonshot API Key
2. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置 Ollama（本地模型）

Ollama 支持在本地运行大语言模型，无需 API 密钥。

1. 确保 Ollama 已安装并运行
   • 访问 Ollama 官网 下载安装
   • 运行 Ollama 服务（默认端口 11434）
   • 下载模型：ollama pull qwen2.5-coder
2. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：Ollama（自定义名称）
     • 供应商：选择"Ollama"
     • 默认模型：从下拉列表选择或手动输入模型名称
     • Base URL：默认 http://localhost:11434（远程服务器可修改）
3. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

配置 LM Studio（本地模型）

LM Studio 提供图形界面管理本地模型，无需 API 密钥。

1. 确保 LM Studio 已安装并运行
   • 访问 LM Studio 官网 下载安装
   • 在 LM Studio 中下载模型并启动本地服务器（默认端口 1234）
2. 新增配置
   • 点击"新增配置"
   • 填写配置信息：
     • 名称：LM Studio（自定义名称）
     • 供应商：选择"LM Studio"
     • 默认模型：从下拉列表选择（支持 Tool Use 的模型排在前面）
     • Base URL：默认 http://localhost:1234
3. 保存并激活
   • 点击"保存"按钮（或按 Enter）
   • 在配置列表中选中该配置，点击"使用"按钮或按 Enter 激活

四、切换配置

方法 1: 托盘菜单快速切换

• 点击托盘图标
• 在配置列表中直接点击要切换的配置
• 当前激活的配置会显示勾选标记

方法 2: 管理窗口切换

• 打开"管理配置"窗口
• 使用 ↑/↓ 或 Tab 键选择配置
• 按 Enter 激活选中的配置

五、测试配置

在保存配置前或配置详情页面，可以点击"测试连接"按钮，验证配置是否正确。

测试结果在配置列表中显示：已测试可用的配置会显示绿色圆点，未测试或测试失败的配置不显示标记。

注意：订阅模式无法测试，其它配置均可测试。测试是可选的，即使测试失败也可以保存和使用配置。

六、常用快捷键

七、配置切换与重启 Claude Code

无需重启

第三方配置（智谱 GLM、阿里 Qwen、MiniMax、DeepSeek、Kimi、其他）之间互相切换，如果仅涉及 URL 和 API Key 变更，无需重启，配置立即生效。

需要重启

以下情况需要重启 Claude Code（执行 /exit 退出后重新运行 claude）：

• 官方配置之间互相切换：订阅(Pro/Max)、订阅(OAuth)、官方 API Key
• 官方配置 ↔ 第三方配置
• Ollama / LM Studio ↔ 其他任何配置
• 配置了模型别名的配置之间切换

订阅(Pro/Max)的特殊操作