当前位置： 首页 > news >正文

Claude Code 命令配置指南

news 2026/5/22 12:39:38

Claude Code 全面配置教程

整理日期：2026-05-22

📋 目录

  1. CLI 命令速览
  2. 配置选项详解
  3. Hooks 配置指南
  4. Slash Commands 配置
  5. 环境变量完整列表
  6. MCP 服务器配置

1. CLI 命令速览

Claude Code 提供了丰富的内置命令，通过 / 前缀调用。

📝 基础命令

命令 用途 示例
/help 显示帮助信息 /help
/clear 清空当前对话 /clear
/compact 压缩上下文减少 token 使用 /compact
/exit 退出当前会话 /exit
/context 显示上下文使用情况 /context
/recap 生成会话摘要 /recap

🔧 配置命令

命令 用途 示例
/config 打开交互式配置菜单 /config
/model 切换模型 /model
/effort 设置努力级别 /effort max
/rename 重命名当前会话 /rename new-name

🔌 插件与扩展

命令 用途 示例
/plugin 插件管理（安装/更新/卸载） /plugin install hookify
/skills 技能管理 /skills
/mcp MCP 服务器管理 /mcp
/reload-plugins 重载所有插件 /reload-plugins

🤖 Agent 与子进程

命令 用途 示例
/agents 管理子代理 /agents
/loop 循环执行命令 /loop 5m /task
/proactive /loop 的别名 /proactive 10m /check

🛡️ 审查与质量

命令 用途 示例
/review 审查 PR /review
/security-review 安全审查 /security-review
/team-onboarding 生成团队入门指南 /team-onboarding
/insights 生成使用分析报告 /insights

🎨 UI 与显示

命令 用途 示例
/focus 切换焦点模式 /focus
/tui TUI 全屏模式 /tui fullscreen
/btw 添加附注 /btw something
/undo 撤销操作（/rewind 的别名） /undo
/rewind 回退会话 /rewind

📤 会话管理

命令 用途 示例
/resume 恢复会话 /resume
/export 导出会话 /export
/feedback 发送反馈 /feedback

2. 配置选项详解

Claude Code 的配置文件位于 ~/.claude/settings.json（全局）或 .claude/settings.json（项目级）。

2.1 完整配置结构

{"model": "claude-opus-4-5","alwaysThinkingEnabled": false,"env": {"ANTHROPIC_AUTH_TOKEN": "your-token","ANTHROPIC_BASE_URL": "https://api.anthropic.com","ANTHROPIC_MODEL": "claude-opus-4-5","API_TIMEOUT_MS": "3000000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1","MCP_TOOL_TIMEOUT": "30000"},"permissions": {"defaultMode": "bypassPermissions","allow": ["Bash(claude doctor:*)", "Bash(curl:*)", "WebSearch"],"deny": []},"skipDangerousModePermissionPrompt": true
}

2.2 配置项详解

🎯 model

设置默认使用的模型：

模型 用途
claude-opus-4-5 最强能力，适用于复杂任务
claude-sonnet-4-7 平衡性能和速度
claude-haiku-3-5 快速响应，轻量任务

2.3 permissions 权限配置

{"permissions": {"defaultMode": "ask|allow|bypassPermissions","allow": ["Bash(npm test:*)", "Edit", "Write"],"deny": ["Bash(rm -rf *)", "Write(/etc/*)"],"additionalDirectories": ["/shared-data"]}
}
模式 说明
ask 每次操作前询问（默认）
allow 自动允许但记录日志
bypassPermissions 完全绕过权限检查

2.4 env 环境变量

在配置文件中设置环境变量：

{"env": {"ANTHROPIC_AUTH_TOKEN": "sk-...","API_TIMEOUT_MS": "3000000","MCP_TOOL_TIMEOUT": "30000"}
}

2.5 skipDangerousModePermissionPrompt

设置为 true 可跳过危险模式权限提示。

3. Hooks 配置指南

Hooks 允许在特定事件发生时自动执行自定义逻辑。

3.1 Hook 类型总览

事件 触发时机 用途
PreToolUse 工具执行前 验证、修改、阻止操作
PostToolUse 工具执行后 反馈、日志、自动修复
Stop Agent 考虑停止时 完整性检查
SubagentStop 子代理完成时 任务验证
UserPromptSubmit 用户提交输入时 上下文添加、验证
SessionStart 会话开始时 加载上下文、设置环境
SessionEnd 会话结束时 清理、日志
PreCompact 上下文压缩前 保留关键信息
Notification 发送通知时 记录、反应

3.2 Hook 配置格式

用户设置格式（.claude/settings.json）

{"PreToolUse": [{"matcher": "Write|Edit","hooks": [{"type": "prompt","prompt": "Validate file write safety. Check: system paths, credentials. Return 'approve' or 'deny'."}]}],"Stop": [{"matcher": "*","hooks": [{"type": "prompt","prompt": "Verify task completion: tests run, build succeeded. Return 'approve' to stop or 'block' with reason."}]}]
}

插件格式（hooks/hooks.json）

{"description": "Plugin hooks description","hooks": {"PreToolUse": [...],"Stop": [...]}
}

3.3 Matcher 匹配器

// 精确匹配
"matcher": "Write"// 多工具匹配
"matcher": "Read|Write|Edit"// 通配符（所有工具）
"matcher": "*"// MCP 工具匹配
"matcher": "mcp__.*__delete.*"// 正则模式
"matcher": "mcp__plugin_.*__.*"

3.4 Hook 类型

Prompt-based Hook（推荐）

{"type": "prompt","prompt": "评估此操作的安全性：$TOOL_INPUT","timeout": 30
}

Command Hook

{"type": "command","command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh","timeout": 60
}

3.5 Hook 输出格式

{"continue": true,"suppressOutput": false,"systemMessage": "Message for Claude"
}

退出码

退出码 说明
0 成功，stdout 显示在 transcript
2 阻塞错误，stderr 反馈给 Claude
其他 非阻塞错误

3.6 实用 Hook 示例

自动格式化（PostToolUse）

{"PostToolUse": [{"matcher": "Edit|Write","hooks": [{"type": "command","command": "prettier --write ${FILE_PATH}"}]}]
}

阻止危险操作（PreToolUse）

{"PreToolUse": [{"matcher": "Bash","hooks": [{"type": "prompt","prompt": "Check if command contains 'rm -rf' or 'dd if='. If dangerous, return 'deny'."}]}]
}

会话开始时加载上下文

{"SessionStart": [{"matcher": "*","hooks": [{"type": "command","command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/load-context.sh"}]}]
}

敏感文件保护

{"PreToolUse": [{"matcher": "Edit|Write|MultiEdit","hooks": [{"type": "prompt","prompt": "Check if file path contains .env, credentials, secrets. If so, return 'deny' with warning."}]}]
}

3.7 Hook 环境变量

变量 说明
$CLAUDE_PROJECT_DIR 项目根目录
$CLAUDE_PLUGIN_ROOT 插件目录
$CLAUDE_ENV_FILE SessionStart 专用：持久化环境变量
$CLAUDE_CODE_REMOTE 是否远程运行

3.8 Hook 事件触发时机

用户输入 → UserPromptSubmit → SessionStart检测 → PreToolUse检测↓工具执行↓PostToolUse检测 ← 成功↓考虑停止? → Stop Hook → SubagentStop检测↓会话结束 → SessionEnd

4. Slash Commands 配置

4.1 内置 Slash Commands

命令 说明
/help 显示帮助
/clear 清空对话
/compact 压缩上下文
/model 切换模型
/config 配置菜单
/mcp MCP 管理
/plugin 插件管理
/skills 技能列表
/agents 代理管理
/review PR 审查
/security-review 安全审查
/loop 循环执行
/init 初始化 CLAUDE.md
/resume 恢复会话
/export 导出会话
/doctor 运行诊断
/undo 撤销（/rewind 别名）
/btw 添加附注
/focus 焦点模式
/tui 全屏 TUI
/team-onboarding 团队入门
/insights 使用分析
/recap 会话摘要
/rename 重命名会话

4.2 自定义 Slash Commands

在插件中创建命令，文件结构：

plugin/
├── commands/
│   └── my-command.md
└── plugin.json

Command 文件格式

---
name: my-command
description: A custom slash command
allowed-tools: ["Read", "Edit", "Bash(npm test:*)"]
---# My Custom CommandSteps:
1. Analyze the request
2. Execute tasks
3. Report results

frontmatter 选项

字段 说明
name 命令名称
description 描述（显示在命令列表）
allowed-tools 允许使用的工具列表
context fork 会在独立上下文运行
agent 指定使用的 agent 类型

5. 环境变量完整列表

5.1 Anthropic API 配置

变量 说明 示例
ANTHROPIC_AUTH_TOKEN API 密钥 sk-...
ANTHROPIC_BASE_URL API 端点 https://api.anthropic.com
ANTHROPIC_MODEL 默认模型 claude-opus-4-5
ANTHROPIC_DEFAULT_OPUS_MODEL Opus 默认 claude-opus-4-5
ANTHROPIC_DEFAULT_SONNET_MODEL Sonnet 默认 claude-sonnet-4-7
ANTHROPIC_DEFAULT_HAIKU_MODEL Haiku 默认 claude-haiku-3-5

5.2 超时与性能

变量 说明 默认值
API_TIMEOUT_MS API 请求超时（毫秒） 300000
MCP_TOOL_TIMEOUT MCP 工具超时 30000
CLAUDE_CODE_MAX_CONTEXT_TOKENS 最大上下文 token -

5.3 Prompt 缓存

变量 说明
DISABLE_PROMPT_CACHING 禁用 prompt 缓存
ENABLE_PROMPT_CACHING_1H 启用 1 小时缓存 TTL
FORCE_PROMPT_CACHING_5M 强制 5 分钟缓存 TTL

5.4 流量与遥测

变量 说明
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 禁用非必要流量
DISABLE_TELEMETRY 禁用遥测
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 启用离开摘要

5.5 渲染与显示

变量 说明
CLAUDE_CODE_DISABLE_TERMINAL_TITLE 禁用终端标题
NO_FLICKER 无闪烁模式
FORCE_HYPERLINK 强制超链接

5.6 Git 集成

变量 说明
CLAUDE_CODE_GIT_BASH_PATH Git Bash 路径
CLAUDE_CODE_PERFORCE_MODE Perforce 模式

5.7 安全与沙箱

变量 说明
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 子进程环境清理
CLAUDE_CODE_SCRIPT_CAPS 限制脚本调用次数
CLAUDE_CODE_CERT_STORE CA 证书存储

5.8 云平台（Bedrock/Vertex/Foundry）

变量 说明
AWS_BEARER_TOKEN_BEDROCK Bedrock 令牌
ANTHROPIC_BEDROCK_BASE_URL Bedrock 端点
CLAUDE_CODE_USE_MANTLE 使用 Mantle
CLAUDE_CODE_SKIP_BEDROCK_AUTH 跳过 Bedrock 认证

5.9 其他

变量 说明
DISABLE_COMPACT 禁用上下文压缩
CLAUDE_CODE_ORGANIZATION_UUID 组织 UUID
TRACEPARENT / TRACESTATE 分布式追踪

6. MCP 服务器配置

MCP（Model Context Protocol）允许扩展 Claude Code 的能力。

6.1 MCP 服务器类型

类型 传输方式 适用场景
stdio 进程 stdin/stdout 本地工具、自定义服务器
sse Server-Sent Events 云服务、OAuth 认证
http REST API API 后端、令牌认证
ws WebSocket 实时数据、流式

6.2 stdio 配置

{"filesystem": {"command": "npx","args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],"env": {"LOG_LEVEL": "debug"}}
}

6.3 SSE 配置

{"asana": {"type": "sse","url": "https://mcp.asana.com/sse"}
}

6.4 HTTP 配置

{"api-service": {"type": "http","url": "https://api.example.com/mcp","headers": {"Authorization": "Bearer ${API_TOKEN}"}}
}

6.5 WebSocket 配置

{"realtime-service": {"type": "ws","url": "wss://mcp.example.com/ws","headers": {"Authorization": "Bearer ${TOKEN}"}}
}

6.6 MCP 配置位置

位置 范围 推荐场景
.mcp.json（项目根目录） 仅当前项目 项目特定配置
~/.claude.json（用户根目录） 所有项目 全局 MCP 服务器
插件 .mcp.json 插件启用时 随插件自动加载

6.7 环境变量展开

所有 MCP 配置支持环境变量：

变量 说明
${CLAUDE_PLUGIN_ROOT} 插件目录（推荐用于便携性）
${API_KEY} 用户环境变量
${DB_URL} 数据库 URL

6.8 MCP 工具命名

MCP 工具自动前缀：mcp__<plugin>_<server>__<tool>

---
allowed-tools: ["mcp__plugin_asana_asana__asana_create_task","mcp__plugin_asana_asana__asana_search_tasks"
]
---

6.9 常用 MCP 服务器推荐

📚 文档与知识

MCP 服务器 用途
context7 实时文档检索（React, Express, Prisma 等）
exa Web 搜索与研究

🌐 浏览器与前端

MCP 服务器 用途
playwright 浏览器自动化、UI 测试
puppeteer 无头浏览器、网页抓取

🗄️ 数据库

MCP 服务器 用途
supabase Supabase 集成
postgresql 原生 PostgreSQL
neon Neon serverless Postgres
turso Turso edge 数据库

📦 版本控制与 DevOps

MCP 服务器 用途
github GitHub Issues、PR、Actions
gitlab GitLab 集成
linear Linear 问题跟踪
docker 容器管理
kubernetes K8s 集群管理

☁️ 云基础设施

MCP 服务器 用途
aws AWS 资源管理
cloudflare Workers, Pages, R2, D1
vercel Vercel 部署

📊 监控与可观测

MCP 服务器 用途
sentry 错误跟踪
datadog APM、日志、指标

💬 通信

MCP 服务器 用途
slack Slack 工作区集成
notion Notion 工作区

6.10 MCP 调试

# 启用 MCP 调试模式
claude --mcp-debug# 查看所有 MCP 服务器
/mcp# 重启后生效

📊 快速参考表

🔧 配置查找路径

配置类型 用户级 项目级 环境变量
settings.json ~/.claude/settings.json .claude/settings.json -
.mcp.json ~/.claude.json .mcp.json -
keybindings ~/.claude/keybindings.json - -
plugins ~/.claude/plugins/ - -

🎯 常用命令速查

操作 命令
查看帮助 /help
清空对话 /clear
压缩上下文 /compact
配置 /config
切换模型 /model
管理 MCP /mcp
管理插件 /plugin
查看技能 /skills
管理代理 /agents
恢复会话 /resume
安全审查 /security-review

🔗 相关资源

  • 官方文档: https://code.claude.com/docs
  • MCP 协议: https://modelcontextprotocol.io/
  • 插件开发: 使用 /plugin-dev 技能

文档版本: 2026-05-22
Claude Code 版本: 2.1.110+

http://www.jsqmd.com/news/864398/

相关文章：

  • OpenClaw 换 “大脑”！DeepSeek V4 默认集成，离线私有 AI 自由
  • AlwaysOnTop：终极Windows窗口置顶解决方案完全指南
  • Grammarly Premium免费使用终极指南：智能Cookie搜索技术完全解析
  • Navicat Premium试用期重置完整指南：三步恢复14天免费试用
  • 为何越来越多工厂选择无线式大屏幕熔炼测温系统？核心原因解读
  • AI写标书靠不靠谱?实测2026热门AI标书工具后，我们有了答案
  • 终极指南：如何利用Py Eddy Tracker实现海洋中尺度涡旋高效识别与追踪
  • BuildingAI 实用技巧
  • string，vector，deque容器的对比
  • ParsecVDD终极指南：5分钟创建高性能虚拟显示器，解锁游戏串流新境界
  • 5个步骤让Windows视频播放体验升级：MPV_lazy懒人包完全指南
  • 江苏GEO优化公司实测榜单：TOP3 技术实力与效果数据全揭晓（2026 年 5 月最新） - GEO排行榜
  • 如何用5分钟完成淘宝25分钟任务：淘金币自动化完整指南
  • PowerToys中文汉化终极指南：让Windows效率工具真正为你所用
  • 2026山东青岛瓷砖空鼓翘边维修公司靠谱品牌排名：雨和虹防水维修/雨盛防水维修/秦鑫斌防水维修/森之澜漏水检测/能亿防水补漏/成诺防水修缮 - 雨和虹防水维修
  • 利用taotoken为开源项目提供可配置的多模型ai能力
  • 期刊论文重复率多少才算合格？
  • AI写标书主流工具实测，选对工具，比多写100页标书更重要
  • 多模型选型实验场景下Taotoken模型广场的价值与应用
  • 普通人从零起步，说服能力是底层核心硬技能
  • 英雄联盟玩家必备的3大效率神器：League Akari本地自动化工具完全指南
  • 3个问题+5大场景：Subtitle Edit如何成为你的免费字幕编辑神器？
  • 终极风扇控制指南：如何用FanControl彻底解决电脑散热噪音问题
  • AI安全实战：AI系统应急响应的实战演练案例
  • 2026年｜别再盲目降AI率！知网AIGC检测从62%→5%，保姆级教程一次讲清 - 降AI实验室
  • Windows热键冲突终极指南：如何用Hotkey Detective快速定位“键盘小偷“
  • 2026国际课程辅导平台TOP3！ - 品牌测评鉴赏家
  • 免费屏幕标注神器gInk：让你的演示和教学更加生动高效的完整指南
  • Zotero SciHub插件技术架构解析：TypeScript实现的学术文献PDF自动化下载方案
  • 知识主权、版本互证与算法殖民：论西方历史叙事的建构性谎言及其在现代大语言模型中的认知操纵