本文迁移自 mindcarver/91ai · 原始位置 docs/ai-coding/claude-code.md · 由 @阿新聊ai 整理。

Claude Code 资料与项目索引

更新日期：2026-05-25
范围：Claude Code CLI、Claude Code GitHub Actions、Claude Agent SDK、CLAUDE.md、slash commands、hooks、subagents、skills、plugins、MCP，以及围绕 Claude Code 的学习资料、生态项目和评测研究。

Claude Code 不只是一个“终端里的聊天式代码助手”。从当前生态看，它更像一个高度可配置的 agentic coding harness：

• CLI：在终端里读代码、改代码、跑命令、做多文件任务。
• CLAUDE.md / Memory：把项目规范、常用命令、架构约定写成长期上下文。
• Slash Commands：把常用工作流沉淀成 /review、/fix-issue、/commit 这类命令。
• Hooks：在工具调用、提交、停止、权限请求等事件上插入自动化和安全检查。
• Subagents / Agent Teams：把研究、审查、实现、测试等任务拆给隔离上下文里的专门 agent。
• Skills / Plugins：把可复用知识、脚本、资源和工作流打包复用。
• MCP：连接 GitHub、Linear、Slack、数据库、浏览器、Figma、监控系统等外部工具。
• GitHub Actions / SDK：把 Claude Code 放进 PR、Issue、CI/CD 和内部自动化系统。

推荐阅读顺序

如果你刚开始了解 Claude Code，建议按这个顺序看：

1. Claude Code overview
2. Claude Code best practices
3. Common workflows
4. Manage Claude's memory
5. Slash commands
6. MCP in Claude Code
7. Hooks reference
8. Create custom subagents
9. Claude Code GitHub Actions
10. Security

官方资料

官方项目

学习资料

入门和官方学习路径

进阶资料

生态项目与能带来的东西

1. Awesome List / 资源索引

2. GitHub / PR / CI 自动化

3. Hooks / Skills / Subagents / Plugins

4. MCP 与外部工具连接

研究与评测资料

使用场景分类

适合优先尝试

• 读懂陌生代码库和快速 onboarding
• 多文件重构和架构迁移
• 测试补全、失败测试定位、CI 问题分析
• 代码审查和安全/性能/可维护性检查
• 文档更新和 README / changelog 维护
• 通过 /commands 固化团队工作流
• 用 subagents 做并行研究、并行 review、独立验证
• 用 hooks 做自动 lint、测试提醒、权限拦截和审计日志

适合谨慎尝试

• 自动修改生产配置
• 自动合并 PR
• 大量第三方 MCP server 同时启用
• 给 subagents 过宽的工具权限
• 让 hooks 执行复杂、有副作用的脚本
• 在不受信仓库或外部 PR 中运行高权限 GitHub Actions

不建议直接交给 Claude Code

• 生产数据库写操作
• 真实用户数据批量修改
• 高风险密钥、部署、权限变更
• 没有测试和回滚方案的核心业务重构
• 法务、安全、财务等最终决策
• 没有人工审查的自动化发布链路

Claude Code 核心机制对比

CLAUDE.md 最佳实践模板

可参考资料：

• Manage Claude's memory
• Claude Code settings
• Claude Code best practices
• On the Use of Agentic Coding Manifests

推荐模板：

# CLAUDE.md

## Project Context

- This repository is ...
- Primary stack:
- Main services / packages:
- Important directories:

## Commands

- Install:
- Lint:
- Type check:
- Test:
- Build:
- Run locally:

## Working Rules

- Keep changes scoped to the requested task.
- Prefer existing patterns and local helper APIs.
- Do not introduce new dependencies without explaining why.
- Update docs when changing behavior or public APIs.

## Testing Expectations

- Run the smallest relevant test first.
- Add or update tests when changing behavior.
- If tests cannot be run, explain why and list the unverified risk.

## Architecture Notes

- Key boundaries:
- Data flow:
- External services:
- Generated files:

## Safety Boundaries

- Do not touch production secrets, tokens, or deployment credentials.
- Do not run destructive commands without explicit approval.
- Do not modify generated artifacts unless the source is updated.
- Do not make production database writes.

## Review Checklist

- Summary of changes
- Tests run
- Risks and assumptions
- Files needing human review

Claude Code GitHub Actions 安全模板

基础模板：

name: Claude Code PR Review

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

permissions:
  contents: read
  pull-requests: write
  issues: write

jobs:
  claude-review:
    if: github.event.pull_request.draft == false
    runs-on: ubuntu-latest

    steps:
      - name: Checkout pull request
        uses: actions/checkout@v4
        with:
          persist-credentials: false

      - name: Run Claude Code review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            Review this pull request for:
            - correctness bugs
            - missing tests
            - security risks
            - breaking changes
            - unclear behavior

            Do not make changes. Return concise findings with file references.
          claude_args: "--max-turns 5"

安全注意：

• 默认先做 review，不自动 push 修复。
• 对外部贡献者 PR 使用更严格触发条件。
• 不要在不受信 PR 上用高权限 token 执行任意脚本。
• permissions 最小化。需要评论才给 pull-requests: write，不要默认给 contents: write。
• secrets 只通过 GitHub secrets 传入，不写入 prompt、日志或 checkout 内容。
• MCP 配置要显式审计，不要让 CI 里的 Claude 连接不必要的外部服务。

Claude Code + MCP 典型组合

横向评测资料

目前没有找到一个同时覆盖 Claude Code、Codex、Cursor、Cline、Gemini CLI 且公开完整任务集、原始输出和评分规则的高质量同任务评测。可参考资料：

建议后续自建评测：

• 固定工具版本、模型、预算、允许命令、上下文和运行次数。
• 任务覆盖 bug fix、测试补全、重构、前端 UI、依赖升级、CI 修复、文档更新。
• 记录 diff、测试结果、耗时、token/费用、人工修正量、越权行为。
• 对 Claude Code 单独评测 hooks、subagents、CLAUDE.md、MCP 是否真的提升稳定性。

评测维度建议

当前判断

Claude Code 最值得关注的地方不是单次代码生成，而是它围绕 agentic coding 形成了一套非常完整的可配置工作流：

• CLAUDE.md 负责项目长期上下文。
• Commands 负责常用操作入口。
• Hooks 负责自动化和治理。
• Subagents 负责隔离和并行。
• Skills / Plugins 负责可复用能力包。
• MCP 负责连接外部工具和数据。
• GitHub Actions / SDK 负责工程平台集成。

因此，Claude Code 适合放在 AI Coding 工具评测的高优先级位置。它的核心评测问题应该是：

Claude Code 能否把复杂软件工程任务拆解成可监督、可审查、可复用、可治理的 agent 工作流？

待补充

• Claude Code 与 Codex、Cursor、Cline、Gemini CLI 的同任务横向评测
• Claude Code hooks / subagents / skills / MCP 的真实工程案例
• Claude Code Action 在公共仓库、私有仓库、外部贡献者 PR 中的安全配置差异
• CLAUDE.md 中文模板和反模式清单
• Claude Code 中文资料质量筛选
• Claude Code 与 Codex 的互相 review 工作流