Logo Vincent
返回文章列表

cc-ping：一行命令 Ping 所有 Claude Code 配置

Claude
cc-ping：一行命令 Ping 所有 Claude Code 配置

为什么需要它

用 Claude Code 的时候，你可能遇到过这样的情况：

  • 你有官方 API Key，也有几个第三方中继，不知道哪个快
  • 你想切换到另一个 Key，但每次都要手动改 ~/.claude/settings.json
  • 你的某个中继挂了，但你不知道——直到 Claude Code 半天没响应

如果你只有一个 API Key，这些问题不存在。但现实中，很多人手里有多个 Key 或中继节点。每次切换都得手动编辑 JSON 文件，改 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL——繁琐、容易出错，而且完全没法比较哪个节点更快。

这就是 cc-ping 要解决的问题。

cc-ping（命令行缩写 ccp）是一个轻量 CLI 工具，帮你管理多个 Claude Code 配置，一键切换，还能并行 Ping 所有节点，按响应时间排序，让你一眼看出哪个最快。

安装

npm i -g cc-ping

安装后就有了 ccp 命令。

基本用法

cc-ping 的命令非常简单，一共六个。

添加配置（ccp add）

$ ccp add
? Enter a name for this config: official
? Token (ANTHROPIC_AUTH_TOKEN): sk-ant-xxx
? Base URL (ANTHROPIC_BASE_URL): https://api.anthropic.com

交互式输入三个信息：名称、Token、Base URL。每个配置对应一组 Claude Code 的认证信息。

你可以添加多个：

$ ccp add
? Enter a name for this config: relay1
? Token (ANTHROPIC_AUTH_TOKEN): cr_xxx
? Base URL (ANTHROPIC_BASE_URL): http://relay1.example.com/api

$ ccp add
? Enter a name for this config: relay2
? Token (ANTHROPIC_AUTH_TOKEN): cr_xxx
? Base URL (ANTHROPIC_BASE_URL): http://relay2.example.com/api

查看所有配置（ccp list）

$ ccp list
Configs:

* official (https://api.anthropic.com)
  relay1 (http://relay1.example.com/api)
  relay2 (http://relay2.example.com/api)

* 标记的是当前正在使用的配置。

切换配置（ccp use）

$ ccp use relay1
Switched to "relay1"
  Token: cr_xxx...
  BaseURL: http://relay1.example.com/api

一行命令完成切换。背后做了两件事：

  1. 在 ~/ccp.json 中记录当前选中的配置名
  2. 把 Token 和 BaseURL 写入 ~/.claude/settings.json 的 env 字段

写入后，下次启动 Claude Code 就会自动使用新的配置。它只修改 env.ANTHROPIC_AUTH_TOKEN 和 env.ANTHROPIC_BASE_URL 这两个字段，你的其他设置（MCP、权限等）完全不受影响。

查看当前配置（ccp now）

$ ccp now
official is now in use

快速确认当前用的是哪个配置。

删除配置（ccp remove）

$ ccp remove relay2
Config "relay2" deleted successfully.

如果删除的恰好是当前正在使用的配置，默认指向会被清除。

Ping：核心功能

这是 cc-ping 最有价值的功能——并行 Ping 所有配置，测试连通性和响应时间。

$ ccp ping
Pinging 3 config(s) in parallel (timeout: 20s)...

  ✓ official (https://api.anthropic.com) 8.3s
  ✓ relay1 (http://relay1.example.com/api) 10.7s
  ✗ relay2 (http://relay2.example.com/api) timeout

它做了什么：

  1. 读取所有已保存的配置
  2. 并行地对每个配置调用 claude --print -p "hi"
  3. 记录每个配置的响应时间
  4. 按响应时间从快到慢排序输出

结果一目了然：✓ 表示正常，✗ 表示超时或出错，耗时直接标在后面。

默认超时 20 秒，可以自定义：

$ ccp ping -t 10   # 10 秒超时

什么时候用 Ping

  • 选择最快的节点：添加了多个中继后，ping 一下看看哪个最快，然后 ccp use 切过去
  • 日常巡检：早上开工前 ping 一下，看看所有节点是否正常
  • 排障：Claude Code 响应特别慢的时候，ping 一下看是不是当前节点的问题，是的话一行命令切到别的节点

数据存在哪里

cc-ping 的数据存储非常简单：

文件位置作用
ccp.json~/ccp.json存储所有配置和当前选中的配置名
settings.json~/.claude/settings.jsonClaude Code 的设置文件，ccp use 会写入 env 字段

ccp.json 的结构大概长这样：

{
  "default": "official",
  "official": {
    "Name": "official",
    "Token": "sk-ant-xxx",
    "BaseURL": "https://api.anthropic.com"
  },
  "relay1": {
    "Name": "relay1",
    "Token": "cr_xxx",
    "BaseURL": "http://relay1.example.com/api"
  }
}

default 字段记录当前激活的配置名，其余字段就是各个配置的详细信息。

使用技巧

技巧一：Ping 完直接切换

$ ccp ping
Pinging 3 config(s) in parallel (timeout: 20s)...

  ✓ relay1 (http://relay1.example.com/api) 5.2s
  ✓ official (https://api.anthropic.com) 8.3s
  ✗ relay2 (http://relay2.example.com/api) timeout

$ ccp use relay1
Switched to "relay1"

先看谁最快，再切过去——两步搞定。

技巧二：配置命名要有辨识度

建议按”提供商 + 特征”命名：

official        # 官方 API
relay-hk        # 香港中继
relay-us        # 美国中继
backup          # 备用 Key

这样 ccp list 和 ccp ping 的输出一眼就能看懂。

技巧三：缩短 Ping 超时

默认 20 秒的超时在日常巡检时有点长。如果你只是想快速看看哪些节点活着，可以缩短超时：

$ ccp ping -t 5

5 秒还没响应的节点，大概率体验也不会好。

写在最后

cc-ping 解决的问题很朴素：让多 Key、多中继的管理不再痛苦。

没有它的时候，你得手动编辑 JSON 文件来切换配置，遇到节点慢了也只能靠感觉。有了它，ccp ping 一下就知道哪个快，ccp use 一下就切过去——整个流程从分钟级降到了秒级。

如果你手里有不止一个 Claude Code 的 API Key 或中继节点，试试 npm i -g cc-ping，让切换和测速变得像 ping 一样简单。

相关推荐

AI-first 创业公司，为什么只需要一种编程语言？

技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。

震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍

躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。

CCBot - 研发提效 24 倍

通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。

Claude Code /add-dir：被低估的 Monorepo 神器

Claude Code 默认只能看到当前目录。/add-dir 打破这个限制——分享我每天跨 5 个仓库使用的经验。

Claude Code 省 Token 小技巧：感叹号的妙用

一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。

我做了个机器人，让团队在飞书里用 Claude Code

CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。

Claude Code /btw 命令详解：不打扰主线的快问快答

详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。

Claude Code /compact：释放上下文，不丢进度

任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。

Claude Code /config：一文搞懂所有可调设置

用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。

Claude Code /context：你的上下文都被什么吃了？

对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。

Claude Code /diff：这次对话改了什么，一目了然

Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。

Claude Code /fast：同样的 Opus，两倍速——值不值？

/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。

Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7

用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。

Claude Code /hooks：让 AI 按你的规矩办事

想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。

Claude Code /init：10 秒自动生成 CLAUDE.md

别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。

Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具

MCP 把 Claude Code 从代码阅读器升级为全栈 Agent。哪些 MCP 服务器值得装、配置怎么写，实测分享。

Claude Code /memory 详解：让 AI 真正记住你的项目

详细介绍 Claude Code 的 /memory 命令和记忆系统——CLAUDE.md 手动指令、Auto Memory 自动记忆、模块化规则，让 Claude 跨会话记住项目规范和个人偏好。

Claude Code /model：Opus、Sonnet、Haiku 怎么选？

不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。

Claude Code /permissions：谁能干什么，你说了算

每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。

Claude Code /plan 详解：先想清楚再动手

详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。

Claude Code + Playwright MCP：AI 终于能"看见"页面了

一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。

Claude Code /resume 命令详解：别让对话白聊

详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。

Claude Code /review：让 AI 帮你做 Code Review

提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。

Claude Code Skills 详解：打造你的专属命令库

详细介绍 Claude Code 的 Skills 功能——创建自定义斜杠命令、复用提示词模板、共享团队最佳实践，让 AI 编程更高效更一致。

Claude Code /stats：看看 AI 到底帮你写了多少代码

好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。

Claude Code /status 命令详解：一眼看清会话全貌

详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。

Claude Code /tasks 命令详解：后台任务尽在掌控

详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。

Claude Code /usage 命令详解：你的额度还剩多少

详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。

Claude Code /vim：在 AI 编程助手里用 Vim 键位

习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。

Claude Code 使用指南：从安装到实战，一篇就够（2026）

用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。

Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚

一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。

Claude Code /agents 详解：自定义 AI 子代理，各司其职

详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。

Claude Code /doctor 详解：一键诊断你的开发环境

详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。

Claude Code /effort 详解：控制 AI 思考的深度

详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。

Claude Code /cost 详解：你的 AI 编程到底花了多少钱

详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。

Claude Code /export 详解：把 AI 对话带走

详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。

Claude Code /rewind 详解：AI 改错了？一键回退

详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。

Claude Code /plugin 详解：给你的 AI 编程助手装插件

详细介绍 Claude Code 的 /plugin 命令——管理插件的安装、启用、禁用和更新，通过插件扩展 Claude Code 的命令、技能、Agent 和 Hook，打造你专属的 AI 编程工具链。

Claude Code /theme 详解：给你的终端换个好看的皮肤

详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。

Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式

详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。

Claude Code /rename 详解：给你的会话取个有意义的名字

详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。

Claude Code settings.json 详解（一）：配置文件在哪里、谁说了算

全面介绍 Claude Code 的配置文件体系——五个配置来源的路径、优先级规则、数组合并与单值覆盖的区别、企业管理设置的多种下发方式。

Claude Code settings.json 详解（二）：permissions 权限系统全解析

深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。

Claude Code settings.json 详解（三）：hooks 钩子全解析

深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。

Claude Code settings.json 详解（四）：env、模型、认证与其他实用字段

全面介绍 Claude Code settings.json 中的 env 环境变量注入、模型配置、身份认证辅助、Git 提交署名、会话清理、语言与界面、思考深度、自动更新、记忆系统等实用字段。

Claude Code Agent Loop：拆解 AI 编程助手的心脏

Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。

© 2026 vincentqiao.com . 保留所有权利。