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 一样简单。

更多同类文章

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