Claude Code 使用指南
1. 前置条件
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| git -version
# node版本18+ node -v
# 执行安装claude code npm install -g @anthropic-ai/claude-code
# 确认是否安装成功 claude --version
|
2. 配置基础设置
注册 https://bigmodel.cn,购买Coding Plan套餐,生成 获取API_KEY参数;
1 2 3 4 5 6
| # 以 macOs配置为例, your_zhipu_api_key为上面获取到的API_KEY参数 export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN=your_zhipu_api_key export ANTHROPIC_MODEL=GLM-4.7
|
3. 使用Claude Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
| # 常用命令 /add-dir #添加新的工作目录 /agents #管理智能体(Agent)配置 /chrome #Chrome中的Claude设置 /clear #清空对话历史并释放上下文 /compact #清空对话历史但保留摘要至上下文(可选:/compact [摘要指示]) /config #打开配置面板 /context #以彩色网格形式可视化当前上下文使用情况 /cost #显示当前会话的总费用与时长 /doctor #诊断并验证你的Claude Code 安装与设置 /exit #退出REPL /export #将当前对话导出到文件或剪贴板 /help #显示帮助与可用命令 /hooks #管理工具事件的钩子(hook)配置 /ide #管理IDE集成并显示状态 /init #初始化新的CLAUDE.md 文件,包含代码库文档 /install-github-app #为仓库设置Claude GitHub Actions /install-slack-app #安装Claude Slack 应用 /login #使用你的Anthropic账户登录 /logout #从Anthropic账户登出 /mcp #管理MCP服务器 /memory #编辑Claude记忆文件 /mobile #显示二维码以下载Claude 移动应用 /model #设置Claude Code使用的AI模型 /output-style #直接或从选择菜单设置输出样式 /permissions #管理允许与拒绝工具权限规则 /plan #查看或打开当前会话的计划 /plugin #管理Claude Code插件 /pr-comments #从GitHub拉取请求获取评论 /release-notes #查看版本发布说明 /resume #恢复某个对话 /review #审查拉取请求 /rewind #将代码和/或对话恢复到之前的某个点 /security-review #对当前分支的待定更改进行安全审查 /skills #列出可用技能 /stats #显示你的Claude Code使用统计与活动 /status #显示Claude Code状态(包括版本、模型、账户、API 连接性与工具状态) /statusline #设置Claude Code的状态栏界面 /stickers #订购Claude Code贴纸 /tasks #列出并管理后台任务 /terminal-setup #安装Shift+Enter键绑定以输入换行 /theme #更换主题 /todos #列出当前待办事项 /upgrade #升级至Max版本以获得更高频率限制和更多Opus功能 /usage #显示计划使用限制 /vim #在Vim与普通编辑模式之间切换
|
4. MCP \ Skills 使用进阶
把MCP理解为Claude Code的外挂,那Skills就是Claude Code的技能包,用完即走,不占任何上下文。
官方的skill指南:https://github.com/anthropics/skills
三方Skill库:awesome-claude-skills
- 文档类Skills
- docx: 不仅仅是读文档,它能像专业编辑一样使用“修订模式”,处理批注,甚至保持原文档的格式排版。
- pptx: 自动生成 PPT 大纲、调整幻灯片布局。
- xlsx: 还在手写 Excel 公式?这个技能让 Claude 变身数据分析师,自动处理复杂的表格转换和图表生成。
- 研发类Skills
- Changelog Generator: 它可以自动分析 git commit 记录,把那些只有程序员看得懂的技术提交,翻译成客户能看懂的“版本更新说明”。产品经理看了都得感动哭。
- Artifacts Builder: 专门用来生成高质量的 UI 组件。配合 Claude 的预览功能,你可以直接用自然语言描述一个网页界面,它能基于 React + Tailwind CSS 生成生产级别的代码。
- Code Quality Checklist: 它内置了代码质量检查清单,写完代码让它跑一遍,相当于有一个严厉的 Tech Lead 帮你做 Code Review。
- 内容与营销类
- Brand Guidelines(品牌卫士): 这个技能太实用了。你可以把公司的品牌色值、字体规范、Tone of Voice(语调)写进去。以后让 Claude 写文案、做图,它就能自动对齐品牌调性,不再“放飞自我”。
- Internal Comms(内部沟通): 写周报、项目复盘、事故报告…这些令人头秃的内部文档,它都有标准模板。你只负责提供核心信息,它负责润色成得体的职场公文。
- Theme Factory: 生成 PPT 或网页时不知道怎么配色?这个技能内置了多种专业配色方案,一键生成高大上的主题风格。
三方Skill库:Compound Engineering Plugin
是一个非常硬核的 Claude Code 插件:
- 实现了 Plan-Work-Review 工程化工作流
- 内置 17 个专业 Agent 进行全方位代码审查
- 通过隔离的 git worktree 确保开发环境干净
- 代码审查专家
| Agent |
职责 |
| kieran-rails-reviewer |
严格的 Rails 代码审查,关注约定和简洁性 |
| kieran-typescript-reviewer |
TypeScript 代码审查,关注类型安全和最佳实践 |
| kieran-python-reviewer |
Python 代码审查,关注清晰性和约定 |
| dhh-rails-reviewer |
DHH 风格的 Rails 审查,强调简洁性哲学 |
| code-simplicity-reviewer |
识别简化复杂代码的机会 |
- 质量守护者
| Agent |
职责 |
| security-sentinel |
全面的安全审计和漏洞检测 |
| performance-oracle |
性能分析和优化建议 |
| data-integrity-guardian |
数据库设计审查和数据一致性检查 |
- 架构与模式
| Agent |
职责 |
| architecture-strategist |
系统设计审查和架构指导 |
| pattern-recognition-specialist |
识别模式并建议改进 |
- 研究与分析
| Agent |
职责 |
| repo-research-analyst |
分析仓库模式和约定 |
| best-practices-researcher |
研究技术最佳实践 |
| framework-docs-researcher |
获取相关框架文档 |
| git-history-analyzer |
分析 git 历史获取上下文和模式 |
- 工作流与沟通
| Agent |
职责 |
| every-style-editor |
编辑内容以匹配 Every 风格指南 |
| feedback-codifier |
将反馈转化为可执行的改进 |
| pr-comment-resolver |
系统化解决 PR 审查评论 |
1 2 3 4 5 6 7 8 9 10 11 12 13
| # Compound Engineering Plugin 配置示意 /plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin /plugin install compound-engineering
# /plugin marketplace add https://github.com/EveryInc/every-marketplace
# 三方的前端skill:frontend-design 配置示意 npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
|