cc claudecc

使用文档

从安装到日常使用，5 分钟上手

安装

从下载页获取 claudecc 安装包，按常规方式安装即可。Windows 用户下载 .exe 后可直接运行（无需安装）；macOS 用户将 .dmg 拖入 Applications；Linux 用户赋予 AppImage 执行权限后直接运行。

claudecc 安装完成后，可一键安装 Claude Code CLI：进入应用内的「安装 Claude Code」页面，claudecc 会自动检测系统环境（如 Node.js、npm、brew 等），下载并安装最新版的 Claude Code。

首次启动

启动后应用会自动：

  • 检测 Claude Code 是否已安装，未安装则提示一键安装
  • 扫描 ~/.claude/settings.json 中已有的第三方模型配置（基于 ANTHROPIC_BASE_URL 存在判定），并自动导入到 claudecc
  • 如果当前已有激活的配置，自动应用为全局配置

导入的模型配置可以直接使用，也可以重新编辑名称、Token 等信息。

新增模型配置

点击右上角「+」按钮，在弹出的表单中填写：

  • 名称：用于在列表中区分（如 minimax、kimi、glm）
  • 模型：API 支持的模型 ID（如 kimi-k2-0711-preview）
  • Base URL：必须兼容 Anthropic 协议的端点
  • Auth Token：你的服务商提供的 API Key

保存后该配置会存储在 ~/.claudecc/profiles.json 中，仅本机可见。

应用配置

在配置详情页点击「应用」按钮，会将该配置的 3 个键写入对应作用域的 settings.json：

  • user → ~/.claude/settings.json（全局生效）
  • project → <项目>/.claude/settings.json（团队共享）
  • local → <项目>/.claude/settings.local.json（仅本机）

写入采用安全策略：只更新 env 块中的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_MODEL，其他字段完全保留。

项目管理

切换到「项目」标签，点击「+」添加项目路径。claudecc 会读取该项目的 settings.json，识别当前生效的模型配置。

在项目视图可以：

  • 查看当前生效的配置详情（含 Token 脱敏显示）
  • 一键切换到其他模型配置
  • 从 settings.json 清除第三方配置（恢复默认 Claude Code 行为）
  • 从 claudecc 移除项目跟踪（不影响 settings.json）

数据存储

claudecc 的所有数据都保存在本地，不上传任何服务器：

  • profiles.json：~/.claudecc/profiles.json（所有模型配置）
  • 更新检查：每次启动静默拉取 update.json（不收集任何设备信息）