{"id":46609726,"url":"https://github.com/next-bin/cc-helper","last_synced_at":"2026-05-21T17:02:09.521Z","repository":{"id":342841572,"uuid":"1175328406","full_name":"next-bin/cc-helper","owner":"next-bin","description":"Coding plan multi-provider \u0026 channels toolkit (by next-bin)","archived":false,"fork":false,"pushed_at":"2026-04-18T07:52:10.000Z","size":4476,"stargazers_count":31,"open_issues_count":0,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T09:35:48.018Z","etag":null,"topics":["cc","cc-helper","coding-plan","plugins","weixin"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/next-bin.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-07T15:04:06.000Z","updated_at":"2026-04-18T07:48:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/next-bin/cc-helper","commit_stats":null,"previous_names":["next-bin/cc-helper"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/next-bin/cc-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-bin%2Fcc-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-bin%2Fcc-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-bin%2Fcc-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-bin%2Fcc-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/next-bin","download_url":"https://codeload.github.com/next-bin/cc-helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-bin%2Fcc-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32150399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cc","cc-helper","coding-plan","plugins","weixin"],"created_at":"2026-03-07T18:08:09.014Z","updated_at":"2026-05-21T17:02:09.486Z","avatar_url":"https://github.com/next-bin.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# CC-Helper\n\n### Claude Code 的全能助手与AI供应商管理工具\n\n[![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg?color=blue\u0026label=version)](https://www.npmjs.com/package/@unitsvc/cc-helper)\n[![npm downloads](https://img.shields.io/npm/dt/@unitsvc/cc-helper.svg?color=green\u0026label=downloads)](https://www.npmjs.com/package/@unitsvc/cc-helper)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-orange.svg)](https://github.com/next-bin/cc-helper)\n[![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE)\n\n[English](README.md) | 简体中文\n\n\u003c/div\u003e\n\n\u003e **⚠️ 声明：智谱（glm/zai）公司及其关联产品禁止使用本软件。**\n\n---\n\n## 环境要求\n\n| 项目        | 版本      |\n| ----------- | --------- |\n| Node.js     | \u003e= 14.0.0 |\n| Claude Code | v2.1.71+  |\n\n```bash\nnpm install -g @anthropic-ai/claude-code@v2.1.126\n```\n\n## 安装\n\n```bash\nnpm install -g @unitsvc/cc-helper@latest\n```\n\n## 更新\n\n```bash\nnpm install -g @unitsvc/cc-helper@latest\n# 或\ncc-helper update\n```\n\n### 代理支持\n\n如果下载失败，使用 `--dl-proxy` 参数：\n\n```bash\n# 使用默认代理\ncc-helper --dl-proxy enable\n\n# 使用自定义代理\ncc-helper --dl-proxy https://your-proxy.com enable\n```\n\n\u003e **注意**：`--proxy` 仍为向后兼容而支持，但已废弃。请使用 `--dl-proxy`。\n\n---\n\n## 快速开始\n\n```bash\n# 启用默认功能（/loop, /btw, /keybindings）\ncc-helper enable\n\n# 启用特定功能\ncc-helper enable loop        # 定时重复提示\ncc-helper enable btw         # 旁支问题\ncc-helper enable keybindings # 自定义键盘快捷键\ncc-helper enable toolsearch  # 动态工具搜索\ncc-helper enable context1m   # 1M 上下文（v2.1.76+）\ncc-helper enable automode    # 所有模型的自动模式（v2.1.75+）\ncc-helper enable monitor     # 流式事件监控（v2.1.100+）\n\n# 查看状态\ncc-helper status\n\n# 禁用所有功能\ncc-helper disable\n```\n\n\u003e **注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量：\n\u003e\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e查看环境变量\u003c/summary\u003e\n\u003e\n\u003e ```json\n\u003e {\n\u003e   \"env\": {\n\u003e     \"DISABLE_INSTALLATION_CHECKS\": \"1\",\n\u003e     \"DISABLE_AUTOUPDATER\": \"1\",\n\u003e     \"DISABLE_BUG_COMMAND\": \"1\",\n\u003e     \"DISABLE_ERROR_REPORTING\": \"1\",\n\u003e     \"DISABLE_TELEMETRY\": \"1\",\n\u003e     \"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC\": \"1\",\n\u003e     \"CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY\": \"1\",\n\u003e     \"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS\": \"1\",\n\u003e     \"CLAUDE_CODE_HIDE_ACCOUNT_INFO\": \"1\",\n\u003e     \"CLAUDE_CODE_NEW_INIT\": \"1\",\n\u003e     \"CLAUDE_CODE_ATTRIBUTION_HEADER\": \"0\",\n\u003e     \"API_TIMEOUT_MS\": \"3000000\"\n\u003e   }\n\u003e }\n\u003e ```\n\u003e\n\u003e \u003c/details\u003e\n\n---\n\n## 配置命令\n\n管理 Claude Code 的 AI Provider 设置、API 密钥、多环境配置以及配置同步。\n\n### plan — 编码计划配置\n\n配置编码计划的第三方 AI Provider，支持 vault 加密存储 API 密钥，并可自定义模型配置以适应不同编码场景。\n\n```bash\n# 添加 Provider（自动保存到 vault + settings.json）\ncc-helper plan add -p bailian -k YOUR_API_KEY\ncc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp\n\n# 切换 Provider\ncc-helper plan switch -p bailian\n\n# 切换模型配置（当前 Provider）\ncc-helper plan switch --profile 1m\n\n# 切换 Provider 并指定配置\ncc-helper plan switch -p bailian -k YOUR_KEY --profile 1m\n\n# 列出 Provider\ncc-helper plan list\n\n# 导出配置\ncc-helper plan export --all-env -o config.json\n```\n\n**1M 上下文标签：**\n\n使用 `--1m` 参数为模型字段添加 `[1m]` 上下文标签，表示支持 1M token 上下文窗口的模型。\n\n\u003e **注意**: `[1m]` 标签需要 Claude Code v2.1.118 或更高版本。\n\n| 参数 | 行为 |\n|------|------|\n| 无 `--1m` | 不添加 `[1m]` 标签 |\n| `--1m d` | 使用配置中的 `Context1M` 字段 |\n| `--1m o` | 覆盖配置，仅标记 opus |\n| `--1m s,o` | 覆盖配置，标记 sonnet 和 opus |\n\n简写：`m=model, h=haiku, s=sonnet, o=opus, r=reasoning`，`d=default（使用配置）`\n\n```bash\n# 示例：切换到 1m 配置并使用默认 1M 字段\ncc-helper plan switch --profile 1m --1m d\n\n# 示例：切换到 3.6 配置，仅标记 opus\ncc-helper plan switch --profile 3.6 --1m o\n\n# 示例：切换 Provider 并标记 sonnet 和 opus\ncc-helper plan switch -p bailian --profile 1m --1m s,o\n```\n\n**支持的 Provider：**\n\n| Provider   | 说明                  |\n| ---------- | --------------------- |\n| `bailian`  | (CN) Aliyun           |\n| `minimaxi` | (CN) MiniMax          |\n| `ark`      | (CN) Ark (Volcengine) |\n| `xiaomi`   | (CN) Xiaomi MiMo      |\n| ~~`glm`~~  | ~~(CN) Zhipu~~        |\n| ~~`zai`~~  | ~~(EN) Zhipu~~        |\n\n**模型配置（Model Profiles）：**\n\n每个 Provider 支持多个模型配置。一个配置定义了所有模型层级的映射：\n\n| 字段      | 说明                                        |\n| --------- | ------------------------------------------- |\n| Model     | 默认模型 (`ANTHROPIC_MODEL`)                |\n| Haiku     | 快速模型 (`ANTHROPIC_DEFAULT_HAIKU_MODEL`)  |\n| Sonnet    | 均衡模型 (`ANTHROPIC_DEFAULT_SONNET_MODEL`) |\n| Opus      | 强力模型 (`ANTHROPIC_DEFAULT_OPUS_MODEL`)   |\n| Reasoning | 扩展思维 (`ANTHROPIC_REASONING_MODEL`)      |\n\n**bailian 配置：**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看 bailian 模型配置\u003c/summary\u003e\n\n| Profile | Model        | Haiku        | Sonnet       | Opus         | Reasoning    | Context1M   |\n| ------- | ------------ | ------------ | ------------ | ------------ | ------------ | ----------- |\n| default | glm-5        | glm-4.7      | glm-5        | glm-5        | glm-5        | -           |\n| 5       | glm-5        | glm-5        | glm-5        | qwen3.6-plus | glm-5        | opus        |\n| 1m      | glm-5        | glm-4.7      | qwen3.5-plus | qwen3.5-plus | glm-5        | sonnet,opus |\n| 3.6     | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | sonnet,opus |\n| kimi    | kimi-k2.5    | kimi-k2.5    | kimi-k2.5    | kimi-k2.5    | kimi-k2.5    | -           |\n| minimax | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | -           |\n\n\u003c/details\u003e\n\n**minimaxi 配置：**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看 minimaxi 模型配置\u003c/summary\u003e\n\n| Profile | Model        | Haiku        | Sonnet       | Opus         | Reasoning    |\n| ------- | ------------ | ------------ | ------------ | ------------ | ------------ |\n| default | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.7 |\n\n\u003c/details\u003e\n\n**ark 配置：**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看 ark 模型配置\u003c/summary\u003e\n\n| Profile  | Model            | Haiku                | Sonnet           | Opus                | Reasoning        |\n| -------- | ---------------- | -------------------- | ---------------- | ------------------- | ---------------- |\n| default  | kimi-k2.6        | kimi-k2.5            | kimi-k2.6        | kimi-k2.6           | kimi-k2.6        |\n| kimi     | kimi-k2.6        | kimi-k2.5            | kimi-k2.6        | kimi-k2.6           | kimi-k2.6        |\n| doubao   | doubao-seed-code | doubao-seed-2.0-code | doubao-seed-code | doubao-seed-2.0-pro | doubao-seed-code |\n| minimax  | minimax-m2.7     | minimax-m2.7         | minimax-m2.7     | minimax-m2.7        | minimax-m2.7     |\n| deepseek | deepseek-v3.2    | deepseek-v3.2        | deepseek-v3.2    | deepseek-v3.2       | deepseek-v3.2    |\n| auto     | glm-5.1          | ark-code-latest      | minimax-m2.7     | glm-5.1             | kimi-k2.6        |\n| glm      | glm-5.1          | glm-4.7              | glm-5.1          | glm-5.1             | glm-5.1          |\n\n\u003c/details\u003e\n\n**xiaomi 配置：**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看 xiaomi 模型配置\u003c/summary\u003e\n\n| Profile    | Model            | Haiku              | Sonnet           | Opus             | Reasoning        | Context1M   |\n| ---------- | ---------------- | ------------------ | ---------------- | ---------------- | ---------------- | ----------- |\n| default    | mimo-v2.5-pro    | mimo-v2.5-flash    | mimo-v2.5-pro    | mimo-v2.5-pro    | mimo-v2.5-pro    | sonnet,opus |\n| pro        | mimo-v2.5-pro    | mimo-v2.5-pro      | mimo-v2.5-pro    | mimo-v2.5-pro    | mimo-v2.5-pro    | sonnet,opus |\n| v2.5       | mimo-v2.5        | mimo-v2.5          | mimo-v2.5        | mimo-v2.5        | mimo-v2.5        | -           |\n| v2.5-flash | mimo-v2.5-flash  | mimo-v2.5-flash    | mimo-v2.5-flash  | mimo-v2.5-flash  | mimo-v2.5-flash  | -           |\n| v2         | mimo-v2-pro      | mimo-v2-omni       | mimo-v2-pro      | mimo-v2-pro      | mimo-v2-pro      | sonnet,opus |\n| omni       | mimo-v2.5        | mimo-v2-omni       | mimo-v2.5        | mimo-v2.5        | mimo-v2.5        | -           |\n\n\u003c/details\u003e\n\n**~~glm / zai 配置~~（禁止使用）**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看 glm/zai 模型配置（已废弃）\u003c/summary\u003e\n\n| Profile | Model        | Haiku       | Sonnet  | Opus    | Reasoning |\n| ------- | ------------ | ----------- | ------- | ------- | --------- |\n| default | glm-5.1      | glm-4.7     | glm-5.1 | glm-5.1 | glm-5.1   |\n| 5       | glm-5        | glm-5-turbo | glm-5   | glm-5   | glm-5     |\n| 5.1     | glm-5.1      | glm-4.7     | glm-5.1 | glm-5.1 | glm-5.1   |\n| 5v      | glm-5v-turbo | glm-4.7     | glm-5.1 | glm-5.1 | glm-5.1   |\n\n\u003c/details\u003e\n\n```bash\n# 示例：在 bailian 上使用 1M 上下文\ncc-helper plan add -p bailian -k YOUR_KEY\ncc-helper plan switch --profile 1m\n\n# 示例：配置 Ark 使用 auto 配置\ncc-helper plan add -p ark -k YOUR_KEY\ncc-helper plan switch --profile auto\n```\n\n### 多窗口配置\n\n使用 `config claude` 生成临时配置，支持多个终端窗口同时使用不同的供应商/模型：\n\n```bash\neval \"$(cc-helper config claude -p bailian)\"                                        # 窗口 1：bailian\neval \"$(cc-helper config claude -p minimaxi)\"                                       # 窗口 2：minimaxi\neval \"$(cc-helper config claude -p glm --profile 5.1 --permission-mode auto)\"       # 窗口 3：glm + auto 权限\neval \"$(cc-helper config claude -p bailian --proxy --profile 1m)\"                   # 窗口 4：bailian 通过代理\n```\n\n**参数说明：**\n\n| 参数 | 说明 |\n|------|------|\n| `-p, --provider` | 供应商 ID（bailian, minimaxi, glm, zai, ark, xiaomi） |\n| `--profile` | 模型 profile（如 5.1, default, kimi） |\n| `--name` | key 名称 |\n| `--api` | 使用 API key 模式 |\n| `--1m` | 1M context 标签 |\n| `--proxy` | 使用代理模式（localhost:12315） |\n| `--port` | 自定义代理端口（默认：12315，范围：1-65535） |\n| `--permission-mode` | 权限模式（bypass, auto, acceptEdits, plan） |\n| `--json` | JSON 格式输出 |\n\n### vault — 安全密钥存储\n\n使用本地加密方式安全存储和读取 Provider 的 API 密钥。\n\n```bash\ncc-helper vault list                              # 列出密钥\ncc-helper vault set bailian default -k \"KEY\"      # 设置\ncc-helper vault get bailian default               # 获取并解密\ncc-helper vault delete bailian default            # 删除\n```\n\n### env — 多环境管理\n\n创建并切换相互隔离的配置环境。\n\n```bash\ncc-helper env list                     # 列出环境\ncc-helper env create work              # 创建\ncc-helper env switch work              # 切换\n```\n\n### sync — Git 配置同步\n\n将 Claude Code 配置备份和恢复到 Git 仓库，全程加密保护。\n\n```bash\n# 登录 GitHub\ncc-helper sync login -r https://github.com/user/repo -t ghp_xxx\n\n# 导出\ncc-helper sync export\ncc-helper sync export --file config.json\ncc-helper sync export --workspace test\n\n# 导入\ncc-helper sync import\n```\n\n---\n\n## 功能特点\n\n| 功能          | 说明                                         |\n| ------------- | -------------------------------------------- |\n| 一键启用      | 启用 `/loop`、`/btw`、`/keybindings`         |\n| 工具搜索      | 可选 `/toolsearch` 用于第三方 API 代理       |\n| 1M 上下文     | 可选 `/context1m` 用于 1M 上下文（v2.1.76+） |\n| 自动模式      | 可选 `automode` 用于所有模型（v2.1.75+）     |\n| Monitor       | 可选 `monitor` 用于流式事件监控（v2.1.100+） |\n| Provider 配置 | `plan` 命令支持 vault 加密存储               |\n| 密钥管理      | `vault` 命令安全管理密钥                     |\n| 多环境支持    | `env` 命令环境切换                           |\n| Git 同步      | `sync` 命令配置同步                          |\n| 轻松恢复      | 自动备份和恢复                               |\n| 零依赖        | 无运行时依赖                                 |\n\n### 截图\n\n![/loop 命令提示](./docs/images/loop-1.png)\n![/loop 执行示例](./docs/images/loop-2.png)\n\n## 支持平台\n\n| 平台    | 架构         |\n| ------- | ------------ |\n| macOS   | amd64, arm64 |\n| Linux   | amd64, arm64 |\n| Windows | amd64, arm64 |\n\n---\n\n## 核心功能详解\n\n### `/loop` - 定时重复提示\n\n定时重复提示，适用于轮询部署、监控 PR、设置提醒、定时执行工作流。\n\n```\n/loop [间隔时间] \u003c提示内容\u003e\n```\n\n**示例：**\n\n```\n/loop 5m check if the deployment finished\n/loop 30m /review-pr 1234\n/loop remind me to push the release at 3pm\n```\n\n| 形式       | 示例                        | 解析间隔     |\n| ---------- | --------------------------- | ------------ |\n| 前置时间   | `/loop 30m check`           | 每 30 分钟   |\n| 后置 every | `/loop check every 2 hours` | 每 2 小时    |\n| 无间隔     | `/loop check`               | 默认 10 分钟 |\n\n支持单位：`s`（秒）、`m`（分）、`h`（时）、`d`（天）\n\n**核心特性：**\n\n- **会话级别**：任务仅在当前会话中存在，退出即消失\n- **自动过期**：3 天后自动过期\n- **抖动保护**：小偏移量防止 API 惊群效应\n- **低优先级**：在你与 Claude 交互间隙触发\n\n```\nwhat scheduled tasks do I have?   # 列出所有任务\ncancel the deploy check job       # 按描述或 ID 取消\n```\n\n### `/btw` - 旁支问题\n\n在不打断主对话的情况下提问旁支问题。\n\n```\n/btw \u003c问题\u003e\n```\n\n**示例：**\n\n```\n/btw 这个函数是做什么的？\n/btw 解释一下这里的错误处理\n/btw 为什么这里要用 async/await？\n```\n\n### `/keybindings` - 自定义键盘快捷键\n\n在 `~/.claude/keybindings.json` 中配置：\n\n```json\n{\n  \"submit\": [\"ctrl+s\"],\n  \"interrupt\": [\"ctrl+c\"],\n  \"custom_commands\": {\n    \"ctrl+shift+l\": \"/loop 5m check status\"\n  }\n}\n```\n\n### `/context1m` - 1M 上下文\n\n为 Claude Opus 模型启用 1M token 上下文窗口。\n\n**要求：**\n\n- Claude Code v2.1.76 或更高版本\n- Claude Opus 4+ 模型\n- 可能需要 Pro 计划或官方 API\n\n![/context1m 启用](./docs/images/1m-1.png)\n\n**扩展思维与上下文长度：**\n\n\u003cdetails\u003e\n\u003csummary\u003e查看上下文长度表格\u003c/summary\u003e\n\n| 模型                 | 最大思维链长度 | 上下文长度 |\n| -------------------- | -------------: | ---------: |\n| qwen3.6-plus         |         81,920 |  1,000,000 |\n| qwen3.5-plus         |         81,920 |  1,000,000 |\n| qwen3-coder-plus     |         不支持 |  1,000,000 |\n| qwen3-max-2026-01-23 |         81,920 |    262,144 |\n| qwen3-coder-next     |         不支持 |    262,144 |\n| kimi-k2.5            |         81,920 |    262,144 |\n| MiniMax-M2.5         |         32,768 |    204,800 |\n| glm-5                |         32,768 |    202,752 |\n| glm-4.7              |         32,768 |    202,752 |\n\n\u003c/details\u003e\n\n### 工具搜索\n\n在运行时动态搜索和加载工具，而非一次性发送所有工具定义。节省 token 并提高性能。\n\n**为什么为第三方 API 启用？** Claude Code 在使用第三方 API 代理时默认禁用工具搜索。此功能为这些代理启用工具搜索。\n\n**优势：**\n\n- **Token 效率**：减少大型 MCP 工具目录的上下文占用\n- **性能提升**：延迟加载，响应更快\n- **代理兼容**：支持 Kimi 和其他提供商\n\n**要求：**\n\n- 代理必须支持 API 响应中的 `tool_reference` 块\n- 仅支持 Claude Sonnet 4+ 和 Opus 4+ 模型（不支持 Haiku）\n\n通过 `ENABLE_TOOL_SEARCH` 环境变量控制：\n\n| 值         | 行为                              |\n| ---------- | --------------------------------- |\n| （未设置） | 默认启用，非第一方主机时禁用      |\n| `true`     | 始终启用                          |\n| `auto`     | MCP 工具超过上下文 10% 时激活     |\n| `auto:\u003cN\u003e` | 自定义阈值（如 `auto:5` 表示 5%） |\n| `false`    | 禁用，所有工具预先加载            |\n\n```bash\nENABLE_TOOL_SEARCH=auto:5 claude   # 5% 阈值\nENABLE_TOOL_SEARCH=false claude    # 禁用\nENABLE_TOOL_SEARCH=true claude     # 始终启用\n```\n\n禁用 MCPSearch 工具：\n\n```json\n{\n  \"permissions\": {\n    \"deny\": [\"MCPSearch\"]\n  }\n}\n```\n\n### 自动模式\n\n为所有模型和 API 类型启用自动模式，绕过模型限制。\n\n**为什么启用？** Claude Code 限制自动模式仅适用于特定模型（Opus/Sonnet 4.6）和官方 API。此功能为所有模型和第三方代理启用自动模式。\n\n**优势：**\n\n- **通用访问**：自动模式适用于任意模型\n- **代理支持**：兼容 Bedrock、Vertex 和第三方 API\n- **无限制**：绕过远程配置控制\n\n**要求：**\n\n- Claude Code v2.1.75 或更高版本\n\n```bash\ncc-helper enable automode\n```\n\n**环境变量：**\n\n| 变量                            | 说明               |\n| ------------------------------- | ------------------ |\n| `CC_HELPER_AUTO_MODE_MODEL`     | 自定义分类器模型   |\n| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 未指定时的回退模型 |\n\n### Monitor\n\n启用 Monitor 工具用于流式事件监控。\n\n**优势：**\n\n- **流式监控**：实时监控日志、文件变化、API 事件\n- **事件驱动工作流**：事件到达时立即响应\n- **持久监控**：在会话期间运行长期监控任务\n\n**要求：**\n\n- Claude Code v2.1.98 或更高版本\n\n```bash\ncc-helper enable monitor\n```\n\n**示例：**\n\n```bash\n# 监控日志文件中的错误\ntail -f /var/log/app.log | grep --line-buffered \"ERROR\"\n\n# 监控文件变化\ninotifywait -m --format '%e %f' /watched/dir\n\n# 轮询 GitHub 获取新的 PR 评论\nwhile true; do\n  gh api \"repos/owner/repo/issues/123/comments?since=$last\" --jq '.[].body'\n  sleep 30\ndone\n```\n\n## 许可证\n\nAGPL-3.0 - 详见 [LICENSE](./LICENSE)\n\n## 安全\n\n### 报告漏洞\n\n如果您发现 cc-helper 的安全漏洞，请负责任地报告：\n\n1. **不要**公开提 issue\n2. 发送邮件给维护者说明详情\n3. 给予合理时间修复后再公开\n\n我们非常重视安全问题，会尽快响应。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnext-bin%2Fcc-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnext-bin%2Fcc-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnext-bin%2Fcc-helper/lists"}