Cc2server — Development skill for Claude Code

[中文](#中文) | [English](#english)

cc2server

中文

A2S 生态（同系列开源仓库）

A2S 按组件拆分为以下同系列仓库，所有者均为 `23J1633`。/ A2S is split into the following sibling repositories, all owned by `23J1633`.

仓库 / Repository	作用 / Role	GitHub
A2Switch	Windows 桌面控制中心 / Windows desktop control center	23J1633/A2Switch
cc2server	Claude Code 桥接器 / Claude Code bridge	23J1633/cc2server
codex2server	Codex 桥接器 / Codex bridge	23J1633/codex2server
dsh2server	DeepSeek Harness 插件 / DeepSeek Harness plugin	23J1633/dsh2server
server-api	中转服务与 Web 控制台 / relay server and Web console	23J1633/server-api
a2s_app	Flutter Android 客户端 / Flutter Android client	23J1633/a2s_app

`cc2server` 把本机 Claude Code 接入 A2S 服务器。它把服务器统一方法映射到 Claude Code 的 `stream-json` 输入/输出协议，并把会话、模型回复、运行状态和错误转换为与 `dsh2server` 相同的事件格式。

桥接器只建立本机到服务器的主动出站连接；本机无需开放端口。

前置条件

• Node.js 22+；
• Claude Code CLI 已安装并完成登录；
• claude --version 能在启动桥接器的用户环境中成功执行；
• 已有 A2S 共享配置，或允许桥接器首次运行时创建一份空端点配置。

安装与诊断

cd D:\Project\A2S\cc2server
npm install
node .\bin\cc2server.js doctor

`doctor` 会检查 Claude 可执行文件并输出配置路径、实例 ID、key 指纹、端点、Claude 版本和默认工作目录，不会输出完整 key。

启动

node .\bin\cc2server.js start

其他命令：

node .\bin\cc2server.js config
node .\bin\cc2server.js status
node .\bin\cc2server.js --version

指定共享配置和 Claude 专用覆盖文件：

node .\bin\cc2server.js start `
  --shared-config D:\config\a2s.json `
  --config D:\config\claude-bridge.json `
  --locale en-US

也可以全局链接命令：

npm link
cc2server doctor
cc2server start

配置

默认共享配置路径：

• Windows：%APPDATA%\A2S\config.json
• macOS：~/Library/Application Support/A2S/config.json
• Linux：`${XDG_C