Claude Code
Anthropic 官方的 AI 编程 CLI。Sigil 与之配合最成熟。
前置条件
- Sigil 已安装 并启动
- Claude Code 已安装
第一步：在 Sigil 生成 Token
打开 Sigil → 左侧 MCP → 客户端管理 → 新增客户端：
- 名称：
claude-code - 范围：根据需要选（推荐先选"全部能力"，后续按 AI 使用边界 收紧）
- 过期：可留空
生成后复制显示的 sk_sigil_xxxxxxxxxx（仅显示一次）。
第二步：编辑 Claude Code 配置
配置文件路径：
| 平台 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.claude\claude.json |
| macOS | ~/.claude/claude.json |
| Linux | ~/.claude/claude.json |
打开后定位 mcpServers 字段。没有就新建：
json
{
"mcpServers": {
"sigil": {
"type": "http",
"url": "http://127.0.0.1:8421/mcp",
"headers": {
"Authorization": "Bearer sk_sigil_xxxxxxxxxx"
}
}
}
}如果 mcpServers 下已经有其他 server（如 playwright / context7），追加 sigil 这一项即可：
json
{
"mcpServers": {
"playwright": { /* 已有 */ },
"sigil": {
"type": "http",
"url": "http://127.0.0.1:8421/mcp",
"headers": { "Authorization": "Bearer sk_sigil_xxxxxxxxxx" }
}
}
}保存。
第三步：重启 Claude Code
退出当前会话（Ctrl+D 或关闭所有窗口），重启进程。
启动后在 Claude Code 中：
/mcp应该能看到：
✅ sigil — connected
Tools: git_query, git_mutate, db_query, db_execute, ...第四步：试一次
让 Claude 用 Sigil 提供的能力做事：
列出我 GitHub 上最近更新的 5 个仓库Claude 会：
- 看到 Sigil 提供的
http_request能力 - 调用它，目标
https://api.github.com/user/repos?sort=updated&per_page=5 - Sigil 在中间挂上 GitHub Token，转发请求
- 脱敏响应后返回
Claude 拿到结果，给你一个 Markdown 表格。
进阶用法
Slash command 联动
在 ~/.claude/commands/<name>.md 写自定义 slash command 时，提示 Claude 优先用 Sigil 能力：
markdown
---
description: 查询 prod 库最近的慢查询
---
请使用 sigil 的 db_query 能力（凭据应自动匹配 prod-db），执行：
\`\`\`sql
SELECT ... FROM pg_stat_statements
ORDER BY total_time DESC LIMIT 10;
\`\`\`
按耗时降序输出，前 10 条。执行 /slow-queries 时，Claude 自动通过 Sigil 跑 SQL。
多 Sigil 实例
如果你有"个人 Sigil"和"工作 Sigil"两套金库（极端场景），可以在 mcpServers 里同时配两个：
json
{
"mcpServers": {
"sigil-personal": {
"type": "http",
"url": "http://127.0.0.1:8421/mcp",
"headers": { "Authorization": "Bearer sk_sigil_personal_..." }
},
"sigil-work": {
"type": "http",
"url": "http://127.0.0.1:8422/mcp",
"headers": { "Authorization": "Bearer sk_sigil_work_..." }
}
}
}Claude 看到两组工具集，命名空间隔离，可独立调用。
但实际上：用一个 Sigil + 标签区分凭据通常更轻量。
工作区联动
在 Sigil 里 注册一个 Git 工作区（Beta），Claude 就能用 git_query.<workspace> / git_mutate.<workspace> 操作具体仓库。
典型流程：
你：帮我看一下当前分支和最近 5 次提交
↓
Claude 调用 git_query.acme-backend(action: status, commits)
↓
你：把改动 commit 一下，再 push
↓
Claude 调用 git_mutate.acme-backend(action: commit, push)
↓ Claude Code 弹窗确认
你点同意 → Sigil 用 github-acme 推到 origin故障排查
/mcp 显示 sigil disconnected
- Sigil 在跑吗？任务栏看一眼
- 端口对吗？Sigil → MCP → 顶部"监听地址"
- Bearer Token 对吗？复制时多了空格 / 引号？
工具调用返回 not_in_scope
- 在 Sigil → MCP → 客户端管理 → 找到
claude-code→ 检查范围 - 改完后不需要重启 Claude Code（Sigil 实时生效）
工具调用返回 confirmation_required
- 这是写类能力的安全机制
- 在 Claude Code 弹窗里点"同意"即可
- 如果完全信任，可以在 Sigil → 设置 → 信任策略 → 标记
claude-code为免确认
Claude 看不到 Sigil 的工具
- 退出整个 Claude Code 进程（不只是关会话）
- 重新打开
- 在新会话里
/mcp检查
工具响应里出现大量 [REDACTED:xxx]
- 这是脱敏正常工作
- 如果你需要看原始数据（如调试 webhook 配置），在 Sigil 审计页查看完整响应（明文出现的部分已被脱敏，但结构保留）
下一步
- 看 Cursor 怎么配：Cursor →
- 看 Cline 怎么配：Cline →
- 看通用 MCP 客户端：通用 MCP 客户端 →