✨ 2025 最新版 · 持续更新

Claude Code 学习教程

从零开始掌握 Anthropic 推出的 AI 编程助手 Claude Code,涵盖入门、中级、高级用法,配合实际示例让你快速上手。

Claude Code AI 编程引擎 开发者输入 自然语言 / CLI 命令 代码输出 文件 / 命令 / Git MCP · Hooks · Skills
Claude Code 核心架构:输入 → AI 引擎处理 → 输出,底层通过 MCP/Hooks/Skills 扩展

⬇️ 安装与环境 入门

安装 Claude Code

支持 macOS、Linux、WSL 和 Windows(PowerShell)。推荐使用终端 CLI 方式:

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex
bash
npm install -g @anthropic-ai/claude-code

启动与登录

bash
# 进入你的项目目录 cd my-project # 启动 Claude Code(首次使用需登录) claude
💡 提示:也可以在 VS Code 扩展商店搜索 "Claude Code" 安装插件,或下载 Desktop 桌面版。

📊 三大终端 AI 编程工具对比 入门

为什么要对比?

2025-2026 年,终端 AI 编程工具爆发式增长。本文重点对比三款最具代表性的工具:Claude Code(Anthropic)、OpenAI Codex CLI(OpenAI)和 OpenCode(开源社区)。它们各有特色,适合不同的开发场景。了解它们的区别,能帮你做出最适合自己的选择。

Claude Code Anthropic · 2025.2 🔥 深度推理 · 准确优先 SWE-bench: 80.8% OpenAI Codex CLI OpenAI · 2025.4 ⚡ 速度优先 · 开源 CLI SWE-bench: 64.7% OpenCode 开源社区 · 2025 🆓 多模型 · 完全免费 已归档 → Crush
三款主流终端 AI 编程工具:各自擅长的领域不同

全面对比总览

维度Claude CodeOpenAI Codex CLIOpenCode
开发商AnthropicOpenAI开源社区(Charmbracelet)
发布时间2025 年 2 月2025 年 4 月2025 年初
许可证闭源(专有)开源(Apache 2.0)开源(MIT)
底层模型Claude Opus 4.6 / Sonnet 4.6GPT-5.4 / GPT-5.3-Codex多模型(Claude/GPT/Gemini 等)
工作流哲学交互式 · 开发者在环异步委派 · 事后审查轻量交互 · 多模型切换
运行环境本地优先(CLI/IDE/Desktop)云端优先 + CLI纯本地终端
安装方式npm install -g @anthropic-ai/claude-codenpm install -g @openai/codexbrew install opencode-ai/tap/opencode

价格对比(2026 年 3 月)

方案Claude CodeOpenAI CodexOpenCode
入门 $20/月(Pro) $20/月(ChatGPT Plus) 免费(开源)
进阶 $100/月(Max 5x) $200/月(ChatGPT Pro) 免费 + 自付 API 费用
重度 $200/月(Max 20x) Business(定制价格) 免费 + 自付 API 费用
团队 $150/用户/月(Teams) Enterprise(定制价格) 免费(自部署)
API 计费 Opus $5/$25 · Sonnet $3/$15(每百万 Token) 约 $0.01-0.12/1K Token 取决于所选模型
💡 实际花费提示:Claude Code Pro($20/月)可能产生超额费,重度使用时实际花费可能超 $100/月。OpenAI Codex 按「信用点」计费(5小时窗口滚动刷新),Plus 计划每 5 小时约 33-168 条消息。OpenCode 本身免费,但你需自行支付各模型的 API 费用。

核心能力 Benchmarks

基准测试Claude CodeOpenAI Codex说明
SWE-bench Verified 80.8% 64.7% 真实 GitHub Issue 修复能力,越高越好
Terminal-Bench 2.0 65.4% 77.3% 终端调试能力,Codex 更擅长
Token 效率 标准(深度推理消耗大) 约 3x 更省 完成相同任务 Codex 约用 1/3 的 Token
上下文窗口 200K Token 128K Token Claude Code 可同时阅读更多文件

各工具深度点评

🟠 Claude Code — 深度推理之王
维度评价
✅ 优势
  • 最强的代码理解力:SWE-bench 80.8% 遥遥领先,擅长复杂多文件重构和架构级任务
  • 超长上下文:200K Token 窗口,可同时理解整个大型代码库
  • 丰富的生态:Skills 系统、Hooks 钩子、MCP 协议、插件市场,扩展性极强
  • 精细化权限控制:6 种权限模式 + allow/deny 规则,安全性优秀
  • 多平台支持:CLI、VS Code、JetBrains、Desktop、Slack、Web 一应俱全
  • 自动记忆系统:CLAUDE.md + Auto Memory,跨会话记住项目规范
❌ 不足
  • 价格较高:深度推理消耗大量 Token,Pro 用户经常触发超额费
  • 闭源:代码不开源,无法自行审查或修改内部实现
  • 官方账号依赖:Desktop 只支持 Anthropic 官方 OAuth 登录
  • 终端调试偏弱:Terminal-Bench 得分低于 Codex
🎯 适合谁复杂架构设计、大型代码库重构、探索性编程、重视代码质量胜过成本的开发者
🔵 OpenAI Codex CLI — 效率与速度之王
维度评价
✅ 优势
  • 极速高效:Token 效率约为 Claude Code 的 3 倍,响应速度更快
  • 终端调试强:Terminal-Bench 77.3%,擅长定位和修复运行时错误
  • 开源 CLI:代码完全公开(Apache 2.0),可审查、修改、二次开发
  • 异步工作流:支持「定义任务 → 云端执行 → 审查结果」的委派模式
  • GitHub 集成强:云端任务容器化执行,自动生成清晰的 PR
  • 生态丰富:ChatGPT 生态无缝衔接,可同时使用对话 AI 和编程代理
❌ 不足
  • 复杂推理偏弱:SWE-bench 64.7%,大型重构和架构任务不如 Claude
  • 上下文窗口小:128K Token,处理超大代码库时不如 Claude
  • 信用点限制:5 小时滚动窗口刷新,重度使用可能不够
  • 云端依赖:部分功能(云端任务、代码审查)需要 Business 以上计划
  • 可定制性有限:缺少 Claude 那样的 Skills/Hooks 系统
🎯 适合谁Bug 修复、终端调试、处理定义明确的工单、追求速度和成本效益的开发者
🟢 OpenCode — 开源多模型瑞士军刀
维度评价
✅ 优势
  • 完全免费开源:MIT 许可证,工具本身不收任何费用
  • 多模型自由切换:支持 Claude、GPT、Gemini、Copilot、Bedrock、Groq、Azure 等
  • 精美 TUI 界面:基于 Bubble Tea 构建,终端体验流畅美观
  • 轻量级:Go 语言编写,启动快、资源占用低
  • MCP 支持:可扩展外部工具,支持 LSP 语言服务
  • 无厂商锁定:不被任何单一 AI 厂商绑定,随时切换模型
❌ 不足
  • 项目已归档:2025 年 9 月已归档,迁移至 Crush(仍处于早期开发阶段)
  • 功能较基础:缺少 Hooks、Skills、子代理等高级功能
  • 无官方支持:社区驱动,出问题需自行排查或依赖社区
  • API 费用自理:虽然工具免费,但使用 Claude/GPT 等模型仍需付费
  • 生态不成熟:插件和扩展远不如 Claude Code 丰富
🎯 适合谁预算有限的学生/开发者、需要多模型切换、偏好开源工具、喜欢终端 TUI 体验的用户

功能矩阵对比

功能Claude CodeCodex CLIOpenCode
文件读写与编辑
Shell 命令执行
MCP 协议支持✅ 内置
Git 深度集成✅ Worktree/PR✅ 云端 PR⚠️ 基础
Hooks 钩子系统✅ 4 种类型⚠️ 有限
Skills 技能系统✅ 丰富⚠️ 自定义命令
子代理/多代理✅ Task + Teams⚠️ 多 Agent
CLAUDE.md / 项目配置✅ 多层级⚠️ codex.md⚠️ opencode.json
自动记忆✅ Auto Memory⚠️ 会话保存
权限管理✅ 6 种模式✅ 3 种级别⚠️ 基础
插件市场✅ 官方市场
IDE 插件✅ VS Code + JetBrains✅ VS Code + JetBrains
桌面应用✅ Claude Desktop✅ macOS App
即时通讯集成✅ Telegram/Discord 等
管道/脚本模式✅ 完整支持✅ -p 模式
CI/CD 集成✅ GitHub Actions✅ GitHub Actions⚠️ 需自行配置

如何选择?

你需要什么? 复杂重构 · 架构设计 → Claude Code Bug 修复 · 终端调试 → OpenAI Codex 零预算 · 多模型切换 → OpenCode 💡 高级建议:同时使用 Claude Code + Codex,各取所长
选择决策树:根据你的需求选择最适合的工具

🧠 高级用户的混合工作流

许多资深开发者同时使用多个工具,发挥各自优势:

  • Claude Code 进行功能开发和复杂重构(代码理解力强、准确率高)
  • OpenAI Codex 进行代码审查和 Bug 修复(速度快、成本低、终端调试强)
  • OpenCode 进行快速原型和小脚本开发(多模型、轻量免费)

安装对比

bash — 三款工具一键安装
# === Claude Code(Anthropic) === npm install -g @anthropic-ai/claude-code # 或使用官方安装脚本 curl -fsSL https://claude.ai/install.sh | bash # === OpenAI Codex CLI(OpenAI) === npm install -g @openai/codex # === OpenCode(开源社区) === brew install opencode-ai/tap/opencode # 或 go install github.com/opencode-ai/opencode@latest # === 各自启动 === claude # Claude Code codex # OpenAI Codex opencode # OpenCode

💬 基础命令 入门

核心交互方式

Claude Code 有三种基本使用方式:交互模式、非交互模式和管道模式。

💬 交互模式 claude 🖨️ 打印模式 claude -p "..." 🔌 管道模式 cat file | claude -p
Claude Code 三种核心使用模式
命令说明示例
claude启动交互式会话进入项目后直接对话
claude "query"带初始提示启动会话claude "解释这个项目"
claude -p "query"非交互打印模式claude -p "列出所有 TODO"
claude -c继续上次对话claude -c
claude update更新到最新版claude update

🚀 第一个任务 入门

实战示例:为项目添加单元测试

假设你有一个 auth.js 模块,想让它自动生成测试:

bash
# 启动 Claude Code claude # 在交互模式中输入: > 为 auth.js 模块编写单元测试,覆盖登录和注册功能,然后运行测试并修复失败用例
💡 实践要点:用自然语言描述需求,Claude Code 会自动读取文件、编写测试、运行并修复。

实战示例:修复 Bug

bash
# 直接把错误信息交给 Claude claude "修复这个 TypeError: Cannot read properties of undefined 错误,它在用户登录时出现" # 或者用管道传入日志 cat error.log | claude -p "分析这个错误的根本原因并提供修复方案"

⚡ 斜杠命令 入门

在交互模式中输入 / 即可查看所有可用命令。以下是常用内置命令:

📋 会话管理命令
命令功能
/clear清除当前会话上下文
/compact压缩会话内容(节省 token)
/cost查看当前会话的 token 使用费用
/resume浏览和恢复历史会话
/rename给当前会话命名
⚙️ 配置与诊断命令
命令功能
/config打开设置配置
/doctor运行诊断检查
/help显示帮助信息
/init初始化项目(创建 CLAUDE.md)
/login / /logout登录/登出账户
/terminal-setup终端环境设置
🎯 捆绑技能命令
命令功能
/review代码审查(检查 diff 或 PR)
/batch <instruction>大规模并行代码变更
/debug [desc]启用调试模式
/loop [interval] <prompt>定时循环执行任务
/simplify [focus]简化和优化代码

📎 文件引用语法 入门

在对话中可以用 @ 符号引用文件或目录,Claude 会自动读取内容:

语法说明示例
@src/utils/auth.js引用单个文件内容"解释 @src/auth.js 中的登录逻辑"
@src/components引用整个目录结构"列出 @src/components 中所有组件"
@server:resource引用 MCP 服务器资源"查看 @jira:PROJ-123 的详情"
💡 技巧:引用文件可以让 Claude 精确理解你讨论的代码,避免歧义。

⚙️ CLI 高级标志 中级

常用命令行标志

标志说明示例
--continue, -c继续当前目录的最近对话claude -c
--resume, -r按 ID 或名称恢复特定会话claude -r "auth-refactor"
--bare精简模式(跳过钩子/技能发现)claude --bare -p "query"
--max-turns N限制 Agent 执行轮数claude -p --max-turns 5 "fix lint"
--output-format输出格式:text / json / stream-jsonclaude -p --output-format json "..."
--verbose显示详细日志claude --verbose
--no-session-persistence不保存会话到磁盘claude -p --no-session-persistence "..."
--worktree在 Git worktree 中工作claude --worktree feature-auth

系统提示词定制

Claude Code 默认系统提示词(内置能力) --append-system-prompt 追加自定义规则 用户输入 / 项目文件上下文
系统提示词的三层叠加结构
标志行为推荐度
--system-prompt完全替换默认提示词⚠️ 谨慎使用
--system-prompt-file用文件内容替换默认提示词⚠️ 谨慎使用
--append-system-prompt在默认提示词后追加文本✅ 推荐
--append-system-prompt-file用文件内容追加到提示词后✅ 推荐
bash
# 追加自定义规则(推荐) claude -p --append-system-prompt "始终使用中文回复,代码注释使用中文" "解释这个文件" # 使用规则文件 claude -p --append-system-prompt-file ./my-rules.txt "重构这个模块"

🔌 管道与脚本模式 中级

Unix 管道集成

Claude Code 可以作为 Unix 管道的一部分,接收其他命令的输出:

bash
# 分析构建错误 cat build-error.log | claude -p "分析构建失败的根本原因" # 审查 Git diff git diff main | claude -p "审查这些代码变更,指出潜在问题" # 分析日志异常 tail -200 app.log | claude -p "如果发现异常就告警" # 提取信息并生成报告 npm audit --json | claude -p "生成安全漏洞修复优先级报告"

脚本自动化

bash
#!/bin/bash # auto-review.sh — 自动代码审查脚本 # 获取最新变更的文件 CHANGED=$(git diff --name-only HEAD~1) # 让 Claude 审查每个文件 for file in $CHANGED; do echo "=== 审查: $file ===" claude -p --bare "审查这个文件的代码质量,只给出改进建议:" "$file" done
bash
# JSON 输出用于程序处理 claude -p --output-format json --max-turns 3 "列出所有 TODO 注释" | jq '.result'

📝 CLAUDE.md 项目配置 中级

什么是 CLAUDE.md?

CLAUDE.md 是项目级别的指令文件,Claude Code 每次启动会自动读取。用于设定编码规范、架构约定和工作流程。

~/.claude/CLAUDE.md — 用户级(个人偏好) ./CLAUDE.md — 项目级(团队共享,纳入版本控制) .claude/rules/*.md — 规则文件(按主题拆分) 自动记忆(Claude 自动生成)
CLAUDE.md 配置层级:优先级从高到低

示例:创建项目 CLAUDE.md

markdown
# 项目规范 ## 技术栈 - 框架:Next.js 14 + TypeScript - 样式:Tailwind CSS - 测试:Vitest + Testing Library ## 编码规范 - 使用 2 空格缩进 - 组件使用函数式写法 + hooks - 文件命名使用 kebab-case - 所有 API 响应必须有错误处理 ## Git 规范 - 提交信息格式:type(scope): description - 例如:feat(auth): add login page ## 测试命令 - `npm test` — 运行所有测试 - `npm test:watch` — 监听模式 ## 架构说明 - src/app/ — Next.js App Router 页面 - src/components/ — 可复用组件 - src/lib/ — 工具函数和共享逻辑 - src/hooks/ — 自定义 Hooks
💡 最佳实践:/init 命令快速生成 CLAUDE.md 模板;文件大小建议控制在 200 行以内。

规则文件拆分

大型项目可以在 .claude/rules/ 下按主题组织规则:

text
.claude/ ├── CLAUDE.md # 主配置文件 └── rules/ ├── typescript.md # TS 相关规则 ├── testing.md # 测试规范 └── api-design.md # API 设计约定

🔀 Git 工作流集成 中级

常用 Git 操作

bash
# 提交代码(Claude 自动生成提交信息) claude "commit my changes with a descriptive message" # 创建 Pull Request claude "create a PR for the feature I just built" # 查看差异并审查 claude "review the changes I made compared to main" # 解决合并冲突 claude "resolve the merge conflicts in src/auth/login.ts"

Git Worktree 并行开发

使用 --worktree 可以在不同分支上同时运行多个 Claude 实例:

bash
# 终端 1:在新功能分支上工作 claude --worktree feature-auth # 终端 2:同时修复 bug claude --worktree bugfix-123
💡 技巧:创建的 PR 会自动与当前会话关联,下次可以用 claude --from-pr <number> 恢复。

🔄 多会话管理 中级

会话命名与恢复

bash
# 创建命名会话 claude -n auth-refactor # 在会话中重命名 > /rename auth-refactor # 恢复特定会话 claude --resume auth-refactor # 继续最近一次对话 claude -c # 在交互模式中浏览历史会话 > /resume

会话切换与跨平台

🌐 跨平台无缝切换

  • /desktop — 将终端会话转移到 Desktop 应用
  • /teleport — 将任务迁移到 Web 端继续
  • 支持在 VS Code、JetBrains、终端、iOS 之间同步

🪝 Hooks 钩子系统 高级

钩子系统概述

Hooks 是用户定义的自动化脚本,在 Claude Code 生命周期的特定节点自动执行。支持四种类型:

类型说明适用场景
command执行 Shell 命令自动格式化、lint 检查
http发送 HTTP POST 请求通知外部系统、Webhook
promptLLM 单轮评估代码质量检查、安全扫描
agent生成子代理多轮验证深度代码审查、复杂验证
SessionStart PreToolUse 拦截/修改 工具执行 Bash/Read/ Write/Edit PostToolUse 格式化/检查 Permission 自动批准/拒绝
Hooks 生命周期:会话开始 → 工具调用前 → 执行 → 工具调用后 → 权限控制

配置示例

钩子配置在 settings.json.claude/settings.json 中定义:

json
{ "hooks": { "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "if": "Bash(rm -rf *)", "command": "echo '⛔ 危险命令已拦截!'" }] }] } }
json
{ "hooks": { "PostToolUse": [{ "matcher": "Write|Edit", "hooks": [{ "type": "command", "command": "prettier --write $FILE", "async": true }] }] } }
json
{ "hooks": { "PermissionRequest": [{ "matcher": "Bash(npm test *)", "hooks": [{ "type": "command", "command": "echo 'approve'" }] }] } }
💡 提示:使用 /hooks 命令查看当前所有已配置的钩子。

🎯 技能 (Skills) 高级

技能系统概述

Skills 是基于提示词的可复用工作流,使用 /skill-name 调用。可以封装常用操作为自定义命令。

📁 技能文件结构

text
.claude/ └── commands/ ├── review-pr.md # /review-pr 技能 ├── deploy-staging.md # /deploy-staging 技能 └── gen-api-docs.md # /gen-api-docs 技能

创建自定义技能

markdown (.claude/commands/review-pr.md)
--- description: 审查当前分支的 Pull Request --- 请审查当前分支相对于 main 分支的所有代码变更: 1. 列出所有变更文件 2. 对每个文件进行代码审查,关注: - 代码质量和可读性 - 潜在的 bug 或安全问题 - 性能问题 - 是否符合项目的编码规范 3. 给出总体评价和改进建议 4. 如果发现严重问题,标注为 🔴 critical

使用技能

bash
# 在交互模式中调用自定义技能 > /review-pr # 调用内置技能 > /batch "将所有 console.log 替换为 logger" > /loop 30 "运行测试,修复失败的用例" > /debug "登录接口返回 500 错误"

🌐 MCP 集成 高级

什么是 MCP?

Model Context Protocol 让 Claude Code 连接外部数据源(如 Google Drive、Jira、Slack、数据库等),实现跨工具协作。

Claude Code MCP Client 📁 Google Drive 📋 Jira 💬 Slack 🗄️ PostgreSQL 🐙 GitHub 🔧 自定义服务 MCP MCP
MCP 架构:Claude Code 通过标准协议连接多种外部服务

配置 MCP 服务器

json (~/.claude/mcp.json)
{ "mcpServers": { "jira": { "command": "npx", "args": ["-y", "@anthropic/mcp-jira"], "env": { "JIRA_API_TOKEN": "your-token" } }, "postgres": { "command": "npx", "args": ["-y", "@anthropic/mcp-postgres"], "env": { "DATABASE_URL": "postgresql://..." } }, "filesystem": { "command": "npx", "args": ["-y", "@anthropic/mcp-filesystem", "/path/to/dir"] } } }
bash
# 配置后,在对话中直接引用 MCP 资源 > 查看 @jira:PROJ-123 的详情 > 在 @postgres:users 表中查找活跃用户 > 读取 @filesystem:docs/README.md 的内容

🤖 多代理协作 高级

多代理工作模式

Claude Code 支持同时运行多个代理实例,由主代理协调完成复杂任务。

主代理 (Coordinator) 任务分解与结果合并 代理 A 前端开发 代理 B 后端 API 代理 C · 测试 代理 D 代码审查 代理 E 文档编写
多代理协作架构:主代理拆分任务,子代理并行执行
bash
# 使用 --worktree 在不同分支上并行运行多个代理 # 终端 1 claude --worktree feat-ui "实现新的用户界面组件" # 终端 2 claude --worktree feat-api "实现对应的 REST API" # 终端 3 claude --worktree feat-tests "编写端到端测试" # 使用 /batch 进行大规模并行变更 > /batch "将所有 .js 文件迁移为 .ts"

🚢 CI/CD 自动化 高级

GitHub Actions 集成

yaml (.github/workflows/claude-review.yml)
name: Claude Code Review on: pull_request: types: [opened, synchronize] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Run Claude Review run: | npm install -g @anthropic-ai/claude-code claude -p --output-format json \ "审查这个 PR 的所有代码变更,给出改进建议" \ | jq -r '.result' > review.md - name: Post Review Comment uses: actions/github-script@v7 with: script: | const fs = require('fs'); const review = fs.readFileSync('review.md', 'utf8'); github.rest.issues.createComment({ ...context.repo, issue_number: context.issue.number, body: review });

定时任务

bash
# 使用 /schedule 创建云端定时任务(即使电脑关机也能运行) > /schedule "每天检查依赖更新,如果有安全漏洞就创建 PR" # 使用 /loop 在会话中循环执行 > /loop 60 "运行测试套件,如果有失败就尝试修复"

🔐 权限与安全模式 高级

为什么权限管理很重要?

AI 编程工具可以读写文件、执行 Shell 命令、访问网络。如果不加控制,AI 可能会误删重要文件、执行危险命令或泄露敏感数据。权限管理系统让你在效率和安全性之间找到平衡。

🔒 严格模式 每步需确认 📋 计划模式 先看计划再执行 ⚡ 自动模式 智能风险判断 🔥 YOLO 模式 全部放行 安全 ←————————————————————→ 效率
权限模式光谱:从最安全到最高效,选择适合你场景的模式

Claude Code 权限管理

Claude Code 提供 6 种权限模式,通过 settings.json 配置:

模式说明安全级别
default默认模式,每次有副作用操作都询问🔒 最安全
plan先展示执行计划,批准后再操作🔒 安全
acceptEdits自动接受文件编辑,命令仍需确认🔓 较安全
auto自动模式,用分类器判断风险高低🔓 中等
dontAsk不询问,但受 allow/deny 规则约束⚠️ 需谨慎
bypassPermissions绕过所有权限检查(YOLO)🔴 危险
bash — Claude Code 开启 YOLO
# 方式 1:命令行临时启用 claude --dangerously-skip-permissions # 方式 2:设为默认模式(settings.json) # { "permissions": { "defaultMode": "bypassPermissions" } } # 推荐:精细控制权限 # { # "permissions": { # "allow": ["Bash(npm test *)", "Bash(git *)", "Read(./src/**)"], # "deny": ["Bash(rm -rf *)", "Read(./.env)", "Read(./secrets/**)"] # } # }

OpenAI Codex CLI 权限管理

级别功能范围适用场景
Read Only仅读取文件代码审查、学习
Auto读写文件 + 运行命令(需确认)一般开发
Full Access完整权限 + 网络访问完整开发流程
bash — Codex 开启 YOLO
# 命令行一键开启 codex --dangerously-bypass-approvals-and-sandbox # 或在 config.toml 中配置 # ~/.codex/config.toml: # approval_policy = "never" # sandbox_mode = "workspace-write" # [sandbox_workspace_write] # network_access = true

三大工具 YOLO 模式速查

工具YOLO 启动命令配置文件
Claude Codeclaude --dangerously-skip-permissions~/.claude/settings.json
OpenAI Codexcodex --dangerously-bypass-approvals-and-sandbox~/.codex/config.toml
Gemini CLIgemini --yolo~/.gemini/settings.json

安全最佳实践

⚠️ 警告:YOLO 模式下 AI 可以执行任何命令、访问网络、修改/删除文件。请务必在受控环境中使用。

✅ 推荐做法

  • 优先用 allow/deny 规则而不是直接开 YOLO,精细控制权限
  • 在隔离环境使用 YOLO:Docker 容器、虚拟机或临时项目
  • 团队环境禁止 YOLO:管理员可通过 managed settings 禁用
  • 定期审查权限配置:使用 /status/approvals 查看
  • 利用沙盒模式(Claude Code 的 /sandbox)作为安全替代方案

🧩 子代理系统 高级

什么是子代理?

Claude Code 的子代理(Sub-agents)是主会话中生成的独立 AI 代理实例,用于处理复杂任务中的子任务。主代理扮演"协调者"角色,将大任务拆分为多个并行子任务,分配给子代理执行,最后汇总结果。

主代理 (Parent) 任务拆分 · 结果汇总 子代理 A 代码探索 子代理 B 文件编写 子代理 C 测试验证 子代理 D 文档编写 子代理 E 代码审查 子代理在独立沙盒中运行,结果汇总回主代理
子代理架构:主代理协调,子代理并行执行子任务

两种子代理模式

🔧 Task 子代理(内置于 Claude Code)

  • 会话内:子代理在当前会话中同步运行
  • 适用:代码探索、文件搜索、批量修改
  • 特点:共享上下文、结果直接返回主代理
  • 触发:Claude 自动判断何时需要创建子代理
bash — 使用场景
# Claude 自动使用子代理的场景(无需手动触发) claude "分析这个项目的架构,找出所有模块间的依赖关系" # 复杂重构 — Claude 会自动创建子代理处理不同模块 claude "将项目从 JavaScript 迁移到 TypeScript,包括所有测试文件" # 大规模代码审查 — 子代理并行审查不同目录 claude "对整个 src/ 目录进行代码审查,重点关注安全性问题"

🧪 Agent Teams(实验性功能)

  • 多实例:创建多个独立 Claude Code 进程
  • 异步:子代理在后台运行,通过消息通信
  • 持久化:每个代理有独立的对话历史
  • 通信:代理之间通过 send_message 交换信息
⚠️ 实验性功能:Agent Teams 目前仍处于实验阶段,API 可能随时变化。生产环境慎用。

子代理 vs 多代理对比

特性Task 子代理Agent TeamsWorktree 并行
运行方式同步、会话内异步、多实例独立终端
上下文共享共享主会话独立上下文完全独立
通信机制直接返回结果消息传递无(需手动协调)
适用规模中小任务大型复杂任务中等任务
稳定性✅ 稳定⚠️ 实验性✅ 稳定

🧠 记忆系统 高级

记忆系统概述

Claude Code 的记忆系统让它能够"记住"跨会话的信息,如项目偏好、编码规范、常见决策等。记忆分为手动配置(CLAUDE.md)和自动学习(Auto Memory)两种方式。

📝 手动记忆 ~/.claude/CLAUDE.md(全局偏好) 项目 CLAUDE.md(团队共享) .claude/rules/*.md(规则文件) 🔄 自动记忆 ~/.claude/projects/<hash>/memory/ Claude 自动写入学习笔记 用 /memory 查看和管理 互补
Claude Code 记忆系统:手动配置 + 自动学习,双管齐下

手动记忆配置

手动记忆是你主动编写的指令文件,Claude Code 每次启动时会自动读取:

bash — 创建全局偏好
# 创建用户级 CLAUDE.md(所有项目生效) mkdir -p ~/.claude cat > ~/.claude/CLAUDE.md << 'EOF' # 个人偏好 ## 语言 - 始终使用中文回复 - 代码注释使用中文 ## 编码风格 - 优先使用 TypeScript - 使用 2 空格缩进 - 优先使用函数式编程 ## 工具偏好 - 使用 pnpm 而非 npm - 使用 Vitest 而非 Jest EOF
bash — 初始化项目记忆
# 方式 1:使用 /init 命令自动生成 claude > /init # 方式 2:手动创建 cat > CLAUDE.md << 'EOF' # 项目规范 ## 架构 - 这是一个 Next.js 14 项目 - 使用 App Router ## 测试 - 运行测试:pnpm test - 测试文件放在 __tests__/ 目录 ## 注意事项 - 不要修改 prisma/schema.prisma(由 DBA 管理) - API 路由必须添加错误处理 EOF
text — 规则文件目录结构
.claude/ ├── CLAUDE.md # 主配置 └── rules/ ├── typescript.md # TS 编码规范 ├── testing.md # 测试规范 ├── api-design.md # API 设计约定 └── security.md # 安全规范 # .claude/rules/security.md 示例: # - 所有 API 端点必须有认证中间件 # - 用户输入必须经过验证和转义 # - 敏感数据不得记录到日志

自动记忆管理

自动记忆存储在 ~/.claude/projects/<hash>/memory/ 目录下,Claude 会在对话中自动学习并保存有用的信息。

命令说明
/memory查看当前项目的所有自动记忆
/memory edit编辑自动记忆文件
claude --no-memory启动时不加载自动记忆
bash — 管理自动记忆
# 查看自动记忆存储位置 ls ~/.claude/projects/*/memory/ # 查看某个项目的记忆文件 cat ~/.claude/projects/$(echo -n "$(pwd)" | shasum | cut -c1-8)/memory/*.md # 禁用自动记忆启动 claude --no-memory # 在对话中让 Claude 记住信息 claude > 请记住:这个项目使用 pnpm 作为包管理器,不要使用 npm

增加/减少记忆的技巧

✅ 增加记忆的方法

  • 直接告诉 Claude:在对话中说"请记住 XXX",Claude 会自动保存到记忆文件
  • 编写 CLAUDE.md:将团队规范、架构决策写入项目级配置文件
  • 使用 /init:Claude 分析项目后自动生成初始配置
  • rules 文件:按主题拆分规则,保持 CLAUDE.md 简洁

🗑️ 减少/清理记忆的方法

  • /memory edit:直接编辑自动记忆文件,删除不需要的内容
  • 手动删除rm ~/.claude/projects/<hash>/memory/*.md
  • --no-memory:临时跳过自动记忆加载
  • 精简 CLAUDE.md:控制在 200 行以内,避免指令过多导致忽略
💡 最佳实践:手动记忆用于稳定不变的规范(编码风格、架构约定),自动记忆用于动态学习的信息(用户偏好、项目特殊处理)。两者互补效果最佳。

💬 即时通讯集成 高级

通过消息平台使用 Claude

Claude Code 支持通过即时通讯平台接收消息并进行编程操作,让你在手机上也能远程控制代码编写。(v2.1.80+ 实验性功能)

Claude Code Channels Plugin 📱 Telegram Telegram Bot 🎮 Discord Discord Bot 💬 iMessage AppleScript 💚 微信 第三方方案
Claude Code Channels:通过即时通讯平台远程控制编程

支持的消息平台

平台集成方式状态适用场景
TelegramBot API 插件✅ 实验性移动端远程编程、团队通知
DiscordBot 插件✅ 实验性社区开发、团队协作
iMessageAppleScript 桥接⚠️ macOS个人使用、快速指令
SlackMCP 服务器✅ 稳定企业协作、CI/CD 通知

配置示例:Telegram Bot

bash — 配置 Claude Code Telegram 频道
# 1. 创建 Telegram Bot(通过 @BotFather) # 获取 Bot Token # 2. 在 Claude Code 中启用频道 claude > /channels # 3. 选择 Telegram,输入 Bot Token # Claude Code 会显示一个验证码 # 4. 在 Telegram 中向 Bot 发送验证码 # 5. 配置完成!现在可以通过 Telegram 发消息给 Claude # 使用示例(在 Telegram 中发送): # "帮我在项目中添加一个用户注册 API" # "运行测试看看有没有失败的" # "查看最近的 Git 提交记录"
⚠️ 安全提示:即时通讯集成会将 Claude Code 的部分功能暴露给消息平台。建议仅用于个人开发环境,避免在生产服务器上使用。务必启用消息来源验证。

🖥️ 桌面端应用 高级

官方 Claude Desktop

Claude Desktop 是 Anthropic 官方推出的桌面应用,提供图形化界面来与 Claude 交互,支持文件拖拽、多窗口、快捷键等特性。

🏛️ 官方应用 Claude Desktop VS Code / JetBrains 📦 开源替代 OpenCode Aider Roo Code / Cline 🔌 IDE 插件 Claude Code (VS Code) JetBrains 插件
Claude 桌面生态:官方应用、开源替代、IDE 插件

应用对比一览

应用类型支持模型特色推荐度
Claude Desktop官方桌面端Claude 全系列原生体验、Artifacts、文件拖拽⭐⭐⭐⭐⭐
Claude Code (VS Code)IDE 插件Claude 全系列终端集成、代码感知、MCP⭐⭐⭐⭐⭐
OpenCode开源终端 TUI多模型轻量、支持 Claude/GPT/Gemini⭐⭐⭐⭐
Aider开源 CLI多模型Git 深度集成、Pair 编程⭐⭐⭐⭐
Roo CodeVS Code 插件多模型可视化、MCP 支持⭐⭐⭐⭐
ClineVS Code 插件多模型自主 Agent、MCP 集成⭐⭐⭐⭐

下载 Claude Desktop

bash — macOS 安装方式
# 方式 1:官网下载(推荐) # 访问 https://claude.ai/download 下载 macOS 版本 # 方式 2:Homebrew 安装 brew install --cask claude # 方式 3:网页版直接使用 # 访问 https://claude.ai
powershell — Windows 安装方式
# 方式 1:官网下载 # 访问 https://claude.ai/download 下载 Windows 版本 # 方式 2:winget 安装 winget install Anthropic.Claude # 方式 3:网页版直接使用 # 访问 https://claude.ai
bash — Linux 安装方式
# Linux 暂无官方桌面客户端 # 推荐使用 Claude Code CLI: npm install -g @anthropic-ai/claude-code # 或使用网页版 # 访问 https://claude.ai

⚠️ 认证方式说明

Claude Desktop 只支持 Anthropic 官方账号登录(OAuth),无法复用 CLI 的环境变量认证。如果你是通过 API Key 或第三方中转使用 Claude Code CLI,Claude Desktop 可能无法直接使用。

认证方式Claude Code CLIClaude DesktopVS Code 插件
claude login(官方 OAuth)
ANTHROPIC_API_KEY⚠️ 部分
ANTHROPIC_AUTH_TOKEN + 自定义 BASE_URL✅ 继承环境变量
⚠️ 重要:如果你使用第三方 API 中转服务,推荐使用 VS Code 插件而非 Claude Desktop——VS Code 插件会继承终端环境变量,无需额外登录。

🔑 无需登录的替代方案:VS Code 插件

如果你已经在 CLI 中配置好了认证(如 API Key 或第三方中转),安装 VS Code 插件是最省事的选择,它会自动继承终端的环境变量

bash — 安装 Claude Code VS Code 插件
# 方式 1:VS Code 命令面板安装 # 1. 打开 VS Code # 2. Cmd+Shift+P → 输入 "Extensions: Install Extensions" # 3. 搜索 "Claude Code" → 点击安装 # 方式 2:命令行一键安装 code --install-extension claude-code # 方式 3:使用 Open VSX Registry(无需 Microsoft 账号) code --install-extension Claude.ai.claude-code
💡 好处:VS Code 插件拥有完整的 Claude Code 功能(文件操作、Shell 命令、MCP、Hooks 等),但提供更好的可视化界面,且自动复用你现有的 CLI 认证配置。

开源替代方案

🆓 OpenCode — 终端 TUI 客户端

轻量级终端界面,支持 Claude、GPT、Gemini 等多模型切换,适合喜欢终端体验的开发者。

bash
# 安装 OpenCode go install github.com/opencode-ai/opencode@latest # 或使用 Homebrew brew install opencode-ai/tap/opencode # 启动 opencode

🤝 Aider — AI 结对编程工具

强大的 Git 集成和 AI 结对编程体验,支持几乎所有主流 AI 模型。

bash
pip install aider-chat aider --model claude-3-5-sonnet

🦊 Roo Code / Cline — VS Code 插件

在 VS Code 中提供自主 Agent 体验,支持 MCP 集成和多模型切换。

text
# 在 VS Code 扩展商店搜索安装: # - "Roo Code" — 功能丰富的 AI 编程助手 # - "Cline" — 自主 AI Agent 插件 # - "Continue" — 开源 AI 代码助手

🏆 热门 Skills Top 10 高级

Skills 是 Claude Code 的技能系统,通过 SKILL.md 文件定义专业能力,让 Claude 在特定场景下自动调用。以下是基于 GitHub Stars 和安装量排名的 2026 年最热门 Skills。

💡 安装方式:SKILL.md 文件放入 ~/.claude/skills/<name>/(用户级)或 .claude/skills/<name>/(项目级)目录即可生效。

1. Frontend Design — 生产级前端界面设计

⭐ 41万+ 安装 Anthropic 官方

生成独特的、生产级的前端界面代码,避免千篇一律的 AI 风格。支持 React、Tailwind、shadcn/ui 等现代前端栈。

bash — 安装
/plugin install frontend-design@claude-plugins-official

🔗 claude.com/plugins

2. Superpowers — 全流程开发技能框架

⭐ 29万+ 安装

结合 TDD、YAGNI、DRY 方法论,提供头脑风暴、子代理开发、代码审查、调试和技能编写的全流程支持。像给 Claude 装上了一整套"超能力"。

bash — 安装
/plugin install superpowers@claude-plugins-official

🔗 claude.com/plugins

3. Code Review — AI 代码审查

⭐ 19万+ 安装 Anthropic 官方

专业代理进行代码审查,基于置信度的 PR 过滤,支持多代理并行审查。可自动检查代码质量、安全漏洞、性能问题。

bash — 安装
/plugin install code-review@claude-plugins-official

🔗 claude.com/plugins

4. Feature Dev — 功能开发工作流

⭐ 14万+ 安装 Anthropic 官方

完整的功能开发工作流,包含探索(Exploration)、设计(Design)和审查(Review)三个阶段的代理,确保功能从需求到交付的质量。

bash — 安装
/plugin install feature-dev@claude-plugins-official

🔗 claude.com/plugins

5. Context Engineering — 上下文工程

⭐ 社区热门

改进提示设计的基础方法论,帮助开发者构建更好的系统提示词,优化 Claude 在复杂场景中的表现。适合需要精细控制 AI 行为的高级用户。

bash — 安装
# 从 GitHub 克隆安装 git clone https://github.com/your-username/context-engineering.git mkdir -p ~/.claude/skills/context-engineering/ cp context-engineering/SKILL.md ~/.claude/skills/context-engineering/

🔗 skillsmp.com

6. Multi-Agent Patterns — 多代理架构模式

⭐ 社区热门

提供协作 AI 系统的多智能体架构设计模式,包括任务分解、并行执行、结果聚合等最佳实践。适合构建复杂的 AI 工作流。

bash — 安装
# 手动安装到用户级目录 mkdir -p ~/.claude/skills/multi-agent-patterns/ curl -o ~/.claude/skills/multi-agent-patterns/SKILL.md \ https://raw.githubusercontent.com/.../multi-agent-patterns/SKILL.md

🔗 skillsmp.com

7. Cloudflare Skill — Cloudflare 全平台开发

⭐ 社区热门

覆盖 Cloudflare 60+ 产品的完整开发指南,包括 Workers、Pages、R2、D1、KV、Durable Objects 等。让 Claude 精通 Cloudflare 生态开发。

bash — 安装
/plugin install cloudflare@claude-plugins-official

🔗 claude.com/plugins

8. Skill Creator — 技能创建向导

⭐ 社区热门

从零开始设计和创建高质量 Skill 的引导向导。如果你想编写自己的 Claude Code 技能,这个技能会手把手教你构建标准化、可复用的 SKILL.md 文件。

bash — 安装
/plugin install skill-creator@claude-plugins-official

🔗 claude.com/plugins

9. Confidence Check — 置信度自检

⭐ 社区热门

让 Claude 在回答前自我评估可靠性和置信度,对不确定的内容主动标注。有效减少 AI 幻觉,提高输出可信度。

bash — 安装
# 手动安装 mkdir -p ~/.claude/skills/confidence-check/ # 下载 SKILL.md 到上述目录 # 详见 https://skillsmp.com

🔗 skillsmp.com

10. Component Refactoring — React 组件重构

⭐ 社区热门

React 组件重构专家,安全地拆分大型组件、优化渲染性能、改善代码结构。自动分析组件依赖关系,确保重构后功能不变。

bash — 安装
# 手动安装 mkdir -p ~/.claude/skills/component-refactoring/ # 下载 SKILL.md 到上述目录 # 详见 https://skillsmp.com

🔗 skillsmp.com

🔌 热门插件 Top 10 高级

Plugins 是 Claude Code 的扩展包系统,打包了命令、代理、钩子、Skills 和 MCP 服务器,一键安装即可获得完整功能。以下是最受欢迎的插件。

💡 安装方式:在 Claude Code 中输入 /plugin install <name>@claude-plugins-official 即可安装。安装后运行 /reload-plugins 生效。

1. GitHub — 官方 GitHub 集成

⭐ 15.8万+ 安装 Anthropic 官方

通过 MCP 协议直接与 GitHub 交互:管理仓库、创建 Issue、操作 PR、代码搜索、触发 CI/CD。开发者日常必备。

bash — 安装
/plugin install github@claude-plugins-official

🔗 claude.com/plugins · GitHub

2. Playwright — 浏览器自动化与端到端测试

⭐ 13.4万+ 安装

微软官方提供的 Playwright MCP 服务器。Claude 可以直接打开浏览器、填写表单、点击按钮、截图、运行端到端测试。前端开发和测试的利器。

bash — 安装
/plugin install playwright@claude-plugins-official

🔗 claude.com/plugins · GitHub

3. Context7 — 实时文档查找

⭐ 21.2万+ 安装

Upstash 出品的 Context7 MCP 服务器,从源代码仓库拉取版本特定的文档和代码示例。Claude 不再依赖过时的训练数据,而是实时查阅最新文档。

bash — 安装
/plugin install context7@claude-plugins-official

🔗 claude.com/plugins · GitHub

4. TypeScript LSP — TypeScript 语言服务器

⭐ 11.6万+ 安装 Anthropic 官方

集成 TypeScript/JavaScript 语言服务器协议,让 Claude 进行真实的类型检查,发现类型错误和 lint 问题,大幅提升 TS 项目的代码质量。

bash — 安装
/plugin install typescript-lsp@claude-plugins-official

🔗 claude.com/plugins

5. Code Simplifier — 代码简化优化

⭐ 15.9万+ 安装 Anthropic 官方

代码清晰度代理,简化并优化最近修改的代码,同时保持功能不变。像"代码美容师"一样让代码更易读、更简洁。

bash — 安装
/plugin install code-simplifier@claude-plugins-official

🔗 claude.com/plugins

6. Ralph Loop — 迭代开发循环

⭐ 12万+ 安装 Anthropic 官方

交互式 AI 循环(Ralph Wiggum 技术),让 Claude 在"编写代码 → 运行测试 → 修复错误 → 再次测试"之间自动迭代,直到所有测试通过。适合 TDD 开发流程。

bash — 安装
/plugin install ralph-loop@claude-plugins-official

🔗 claude.com/plugins

7. Awesome Claude Plugins (Composio) — 跨服务工作流协调器

⭐ 社区热门

精选的插件注册中心和工具路由器,集成 500+ SaaS 应用(Google、Slack、GitHub、Jira 等),可将 Claude 变身为跨服务的工作流自动化引擎。

bash — 安装
git clone https://github.com/composio/awesome-claude-plugins.git cd awesome-claude-plugins claude --plugin-dir ./connect-apps # 然后在 Claude Code 中运行 /connect-apps:setup

🔗 GitHub

8. Claude-Mem — 长期记忆增强

⭐ 社区热门

为 Claude 添加持久化的长期记忆能力,使用 SQLite + Chroma 进行混合搜索,让 Claude 跨会话记住用户偏好、项目上下文和重要决策。

bash — 安装
# 从 GitHub 安装 git clone https://github.com/your-repo/claude-mem.git cd claude-mem claude --plugin-dir .

🔗 claude.com/plugins

9. Plannotator — 可视化计划审查

⭐ 社区热门

增强 Claude Code 的规划模式(Plan Mode),生成结构化的、可注释的执行计划。方便你在 Claude 执行前审查每一步,支持团队协作审查。

bash — 安装
/plugin install plannotator@claude-plugins-official

🔗 claude.com/plugins

10. Shipyard — 企业级生产流程

⭐ 社区热门

在 Superpowers 基础上增加了 IaC(基础设施即代码)验证和安全审计功能,适合需要严格合规检查的企业级项目开发流程。

bash — 安装
/plugin install shipyard@claude-plugins-official

🔗 claude.com/plugins

插件管理速查

命令说明
/plugin打开插件管理界面(发现/已安装/市场)
/plugin install <name>@<market>安装插件
/plugin uninstall <name>@<market>卸载插件
/plugin enable <name>@<market>启用插件
/plugin disable <name>@<market>禁用插件
/reload-plugins重新加载所有插件(无需重启)
/plugin marketplace add <source>添加第三方市场
⚠️ 安全提示:插件是高信任组件,可以执行任意代码。请仅从 Anthropic 官方市场或你信任的来源安装。

📋 速查表

命令说明
claude启动交互会话
claude "query"带提示启动会话
claude -p "q"非交互打印模式
claude -c继续上次对话
claude -r "name"恢复指定会话
claude -n "name"创建命名会话
claude update更新 Claude Code
claude config打开配置
命令说明
/help帮助
/clear清除会话
/compact压缩上下文
/cost查看费用
/init初始化项目
/review代码审查
/debug调试模式
/loop循环执行
/batch批量变更
/simplify简化代码
/resume恢复历史会话
/rename重命名会话
标志说明
-p, --print打印模式
-c, --continue继续对话
-r, --resume恢复会话
--bare精简模式
--max-turns N限制轮数
--output-format输出格式
--verbose详细日志
--worktreeGit worktree
--append-system-prompt追加系统提示词
快捷键说明
Esc中断当前操作
Ctrl+C取消 / 退出
Ctrl+O切换详细模式
↑ / ↓浏览历史输入
Tab自动补全

❓ 常见问题

Claude Code 会在未经同意的情况下修改我的代码吗?

不会。Claude Code 在执行文件修改、Shell 命令等操作前会请求你的许可。你可以通过 --permission-mode 调整权限级别,也可以用 Hooks 自动批准特定安全操作。

如何节省 token 使用量?

使用 /compact 压缩会话上下文;使用 --max-turns 限制执行轮数;使用 --bare 跳过不必要的发现阶段;合理使用 CLAUDE.md 减少重复解释。

CLAUDE.md 指令不被遵循怎么办?

1) 确认文件位置正确(项目根目录或 .claude/CLAUDE.md);2) 使用 /memory 查看加载状态;3) 确保指令具体明确;4) 检查是否有冲突指令。

如何在团队中共享配置?

CLAUDE.md.claude/ 目录纳入 Git 版本控制。团队成员拉取代码后即可共享项目规范、技能和钩子配置。个人偏好放在 ~/.claude/CLAUDE.md

支持哪些 MCP 服务器?

官方支持的包括 Google Drive、Jira、Slack、PostgreSQL、Filesystem、GitHub 等。你也可以通过 MCP SDK 构建自定义服务器,任何能提供工具或资源的 HTTP/WebSocket 服务都可以接入。

什么时候该用 YOLO 模式?有什么风险?

YOLO 模式适合在隔离环境(Docker 容器、虚拟机)中执行自动化任务,如批量重构、生成测试、CI/CD 流水线等。风险:AI 可能误删文件、执行危险命令、访问敏感数据。建议优先使用 allow/deny 精细规则,只在确信安全的环境下开启 YOLO。

📚 作者:磊哥哥科技拆解室

📜 开源协议:Apache License 2.0

本教程引用的开源代码和网页内容均已标注来源,版权归原作者所有。