【学习笔记】Claude Code Bin 详解

插件启用前：
  Claude 执行 Bash → 只能找到系统 PATH 中的命令

插件启用后：
  Claude 执行 Bash → 系统PATH + 插件 bin/ 目录
                        ↑
                        glm-statusline-install.js 现在可以直接调用

插件启用时：
  PATH = /usr/bin:/bin:/usr/local/bin:...:/path/to/plugin/bin/

Claude 执行 Bash("glm-statusline-install.js install")
  ↓
在 PATH 中找到 /path/to/plugin/bin/glm-statusline-install.js
  ↓
执行该脚本

PATH = ...:plugin-a/bin/:plugin-b/bin/:plugin-c/bin/

chmod +x bin/my-script.js

#!/usr/bin/env node
// Node.js 脚本

const args = process.argv.slice(2);
console.log(`Hello, ${args[0]}!`);

#!/usr/bin/env bash
# Bash 脚本

echo "Hello, $1!"

#!/usr/bin/env python3
# Python 脚本

import sys
print(f"Hello, {sys.argv[1]}!")

bin/
├── my-tool.js       ← 薄入口（几行代码）
└── my-tool-core.js  ← 核心逻辑（大量代码）

bin/my-tool.js 内容：
  #!/usr/bin/env node
  require('../my-tool-core.js');

bin/
├── my-plugin-install.js     ← 安装逻辑
└── my-plugin-uninstall.js   ← 卸载逻辑

bin/
└── my-statusline.js         ← 状态行命令

bin/
├── format.sh                ← 代码格式化
├── lint.sh                  ← 代码检查
└── test-runner.sh           ← 测试运行

skills/install/SKILL.md
  ↓ 告诉 Claude 执行
bin/my-plugin-install.js

skills/format/SKILL.md
  ↓ 告诉 Claude 执行
bin/format.sh

---
description: Install the plugin.
---

## Installation

Run the installer:

\`\`\`bash
my-plugin-install.js install $ARGUMENTS
\`\`\`

Then report the result.

\`\`\`bash
bash ${CLAUDE_SKILL_DIR}/../scripts/helper.sh
\`\`\`

# 在项目根目录直接运行
node bin/my-script.js arg1 arg2

# 或先加上执行权限
chmod +x bin/my-script.js
./bin/my-script.js arg1 arg2

# 模拟 status line stdin
echo '{"model":{"display_name":"Sonnet"}}' | node bin/my-statusline.js

# 让 Claude 检查 bin/ 是否在 PATH 中
echo $PATH | tr ':' '\n' | grep plugin

# 让 Claude 列出插件 bin/ 内容
ls -la /path/to/plugin/bin/

#!/usr/bin/env node
// bin/my-tool.js — 入口文件（保持极短）
require('../my-tool-core.js');

// 好：只使用 Node.js 标准库
const fs = require('fs');
const path = require('path');
const http = require('http');

// 不好：依赖第三方包
const axios = require('axios');
const lodash = require('lodash');

#!/usr/bin/env node

try {
  // 主逻辑
  const result = doWork();
  console.log(result);
} catch (err) {
  // status line 脚本必须输出安全兜底
  console.log('Status: unavailable');
  if (process.env.MY_PLUGIN_DEBUG === '1') {
    console.error(err.message);
  }
}

#!/usr/bin/env node

const args = process.argv.slice(2);

if (args.includes('--help') || args.includes('-h')) {
  console.log('Usage: my-tool.js [command] [options]');
  console.log('');
  console.log('Commands:');
  console.log('  install   Install the plugin');
  console.log('  uninstall Uninstall the plugin');
  process.exit(0);
}

const command = args[0] || 'help';
// ...

# 好：小写、连字符分隔
bin/
├── my-tool.js
├── my-tool-install.js
└── my-tool-configure.js

# 不好：大写、下划线、空格
bin/
├── MyTool.js
├── my_tool_install.js
└── my tool configure.js

bin/
├── glm-statusline.js          ← 状态行入口（4 行）
└── glm-statusline-install.js  ← 安装/配置/卸载 CLI（约 440 行）

#!/usr/bin/env node
'use strict';
// Thin wrapper: delegates to the root-level single-file script.
require('../glm-statusline.js');

{
  "statusLine": {
    "type": "command",
    "command": "'/usr/local/bin/node' '/Users/you/.claude/glm-statusline-launcher.js'",
    "refreshInterval": 5,
    "padding": 0
  }
}

# 安装：写入 settings.json 的 statusLine
glm-statusline-install.js install

# 配置：交互式选择字段
glm-statusline-install.js configure

# 卸载：移除 statusLine 配置
glm-statusline-install.js uninstall

\`\`\`bash
glm-statusline-install.js install $ARGUMENTS
\`\`\`