hello2cc

hello2cc

Make third-party models inside Claude Code behave closer to a native Opus session.

hello2cc does not replace your gateway, provider mapping, or account setup.
It sits in the plugin layer and keeps third-party models closer to Claude Code's native behavior around tool choice, agent routing, task and team workflow, failure handling, and response style.

Language: English | 简体中文

Overview

hello2cc is for users who already run GPT, Kimi, DeepSeek, Gemini, Qwen, or other third-party models in Claude Code through CCSwitch or a similar mapping layer.

It helps in three places:

• keep capability selection closer to Claude Code's native priorities
• reduce routing mistakes around plain agents, teams, tasks, and follow-up workflow
• tighten response behavior so replies stay more direct, restrained, and execution-first

Best for

• Claude Code sessions already connected to third-party models
• repositories that expose skills, workflows, MCP resources, or plugins
• users who want fewer detours and less prompt-shape sensitivity

Not for

• setting up API keys, providers, or model gateways
• exposing tools that Claude Code itself did not surface
• replacing CCSwitch or another provider-mapping layer
• overriding repository rules such as AGENTS.md, CLAUDE.md, or direct user instructions

What's new in 0.5.11

Compared with the previous public release (v0.5.9), 0.5.11 adds two practical fixes and one behavior tightening pass:

Area	What changed
Task completion	TaskCompleted / TaskUpdate(status=completed) no longer gets hard-blocked just because the description is thin; the hook now warns without breaking completion-state sync
New Claude Code compatibility	The old Task subagent tool name is now treated as an alias of Agent, covering hooks, capability detection, session continuity, and real-session regression checks
Output discipline	Explanation and comparison prompts are less likely to trigger team/task-board demos, and the native style now pushes replies toward concise, direct, low-ceremony wording

Features

• Native-first routing guidance: keeps the model closer to Claude Code's surfaced capability order instead of falling back to broad keyword-driven choices.
• Agent and team guardrails: distinguishes plain workers from real teammate flows, reduces accidental team_name pollution, and preserves task-board continuity only when the host proves it exists.
• Task lifecycle protection: keeps task creation and task completion checks separate so a completed task is less likely to stay out of sync with the board.
• Task-to-Agent compatibility: supports both old and new Claude Code subagent tool names in the same plugin build.
• Response-style tightening: reduces over-planning, forced confirmations, tool theater, meta narration, jargon-heavy phrasing, and invitation-style endings.
• ccstatusline bridge: backfills status-line usage from transcripts when Claude Code surfaces zeroed usage fields in third-party-model sessions.

Quick Start

Prerequisites

• Node.js 18 or later
• Claude Code with plugin support
• a working third-party model mapping layer such as CCSwitch, if you are not using native Claude models

Install

1. Clone the repository.

   git clone https://github.com/hellowind777/hello2cc.git
   cd hello2cc
   

2. Add the local marketplace entry.

   claude plugins marketplace add "<repo-path>"
   

   Replace <repo-path> with your local hello2cc repository path.

3. Install and enable the plugin.

   claude plugins install hello2cc@hello2cc-local
   claude plugins enable hello2cc@hello2cc-local
   

4. Reload Claude Code.

   /reload-plugins
   

Verify

Run:

claude plugins list

Expected result:

• hello2cc@hello2cc-local is installed
• the plugin status is enabled
• new sessions no longer rely on a plugin-shipped settings.json to force agent=hello2cc:native

Recommended configuration

Minimal configuration

Good when your model mapping is already handled elsewhere and you only want hello2cc to align behavior:

{
  "mirror_session_model": true
}

Stable default agent slot

Good when you want most spawned agents to use the same Claude slot:

{
  "mirror_session_model": true,
  "default_agent_model": "opus"
}