Claude Code 使用指南

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

  1. 文档类Skills
  • docx: 不仅仅是读文档,它能像专业编辑一样使用“修订模式”,处理批注,甚至保持原文档的格式排版。
  • pptx: 自动生成 PPT 大纲、调整幻灯片布局。
  • xlsx: 还在手写 Excel 公式?这个技能让 Claude 变身数据分析师,自动处理复杂的表格转换和图表生成。
  1. 研发类Skills
  • Changelog Generator: 它可以自动分析 git commit 记录,把那些只有程序员看得懂的技术提交,翻译成客户能看懂的“版本更新说明”。产品经理看了都得感动哭。
  • Artifacts Builder: 专门用来生成高质量的 UI 组件。配合 Claude 的预览功能,你可以直接用自然语言描述一个网页界面,它能基于 React + Tailwind CSS 生成生产级别的代码。
  • Code Quality Checklist: 它内置了代码质量检查清单,写完代码让它跑一遍,相当于有一个严厉的 Tech Lead 帮你做 Code Review。
  1. 内容与营销类
  • Brand Guidelines(品牌卫士): 这个技能太实用了。你可以把公司的品牌色值、字体规范、Tone of Voice(语调)写进去。以后让 Claude 写文案、做图,它就能自动对齐品牌调性,不再“放飞自我”。
  • Internal Comms(内部沟通): 写周报、项目复盘、事故报告…这些令人头秃的内部文档,它都有标准模板。你只负责提供核心信息,它负责润色成得体的职场公文。
  • Theme Factory: 生成 PPT 或网页时不知道怎么配色?这个技能内置了多种专业配色方案,一键生成高大上的主题风格。

三方Skill库:Compound Engineering Plugin

是一个非常硬核的 Claude Code 插件:

  • 实现了 Plan-Work-Review 工程化工作流
  • 内置 17 个专业 Agent 进行全方位代码审查
  • 通过隔离的 git worktree 确保开发环境干净
  1. 代码审查专家
Agent 职责
kieran-rails-reviewer 严格的 Rails 代码审查,关注约定和简洁性
kieran-typescript-reviewer TypeScript 代码审查,关注类型安全和最佳实践
kieran-python-reviewer Python 代码审查,关注清晰性和约定
dhh-rails-reviewer DHH 风格的 Rails 审查,强调简洁性哲学
code-simplicity-reviewer 识别简化复杂代码的机会
  1. 质量守护者
Agent 职责
security-sentinel 全面的安全审计和漏洞检测
performance-oracle 性能分析和优化建议
data-integrity-guardian 数据库设计审查和数据一致性检查
  1. 架构与模式
Agent 职责
architecture-strategist 系统设计审查和架构指导
pattern-recognition-specialist 识别模式并建议改进
  1. 研究与分析
Agent 职责
repo-research-analyst 分析仓库模式和约定
best-practices-researcher 研究技术最佳实践
framework-docs-researcher 获取相关框架文档
git-history-analyzer 分析 git 历史获取上下文和模式
  1. 工作流与沟通
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