TLS Observer Claude Code Installer

一键安装 @volcengine/tls-observer-claude-code 到 Claude Code skills-dir。

安装

npm exec -y \
  --package=@volcengine/tls-observer-claude-code-install -- \
  tls-observer-claude-code-install

安装器默认从 registry 下载插件 @latest。使用 beta：

npm exec -y \
  --package=@volcengine/tls-observer-claude-code-install -- \
  tls-observer-claude-code-install --beta

--plugin-version <version> 可以指定精确版本或 dist-tag，并覆盖 --beta。

安装结果

• 插件：~/.claude/skills/tls-observer-claude-code
• 配置：~/.claude/settings.json
• TLS env：~/.claude/tls-observer-claude-code.env
• 运行数据：~/.claude/plugins/data/tls-observer-claude-code

安装器会设置：

{
  "enabledPlugins": {
    "tls-observer-claude-code@skills-dir": true
  },
  "env": {
    "CLAUDE_CODE_TLS_ENV_FILE": "~/.claude/tls-observer-claude-code.env"
  }
}

非交互安装

npm exec -y \
  --package=@volcengine/tls-observer-claude-code-install -- \
  tls-observer-claude-code-install \
  --non-interactive \
  --force \
  --trace-topic-id <trace-topic-id> \
  --api-key <api-key>

TLS Region 默认是 cn-beijing，TLS Producer endpoint 会自动生成为 tls-cn-beijing.volces.com。如需切换 Region，使用 --region <region>；如需单独覆盖 endpoint，使用 --tls-endpoint <host>。旧的 --otel-endpoint 仅保留兼容。

AK/SK 模式将 --api-key 替换为 --ak、--sk，并可提供 --project-name、--app-name 自动准备 TLS LogApp。

本地开发

emo run build --filter @volcengine/tls-observer-claude-code
emo run check --filter @volcengine/tls-observer-claude-code-install
emo run build --filter @volcengine/tls-observer-claude-code-install

CLAUDE_CODE_PLUGIN_SOURCE="$PWD/packages/claude-code" \
node packages/claude-code-install/bin/tls-observer-claude-code-install.mjs --force

安装器会读取源码包的 publishConfig.directory，因此本地开发与正式发布都会使用构建生成的 dist-package。

sync-plugin 仅用于生成安装器内的开发快照；正式安装路径以 registry 下载插件为准。