Claude Code
安装与配置
安装
npm install -g @anthropic-ai/claude-code
claude --version
claude
配置
Window 配置
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL命令详解
账户与认证
/login — 登录 Anthropic 账户
/logout — 登出账户
/upgrade — 升级至 Max 版本
常用快捷键
! — Bash模式：在提示词前加!可直接执行Shell命令，例如 !ls -la
@ — 引用文件：用@引用本地文件路径，将文件内容纳入上下文，例如 @src/main.py
双击Esc — 清空输入：快速清除当前输入框中的所有内容，重新开始
Alt+V — 粘贴图片：将剪贴板中的图片直接粘贴到输入框，进行图像相关提问
Ctrl+O — 详细输出：开启后可以看到更详细的运行日志和调试信息
Meta+O — 切换快速模式：在速度优先和质量优先之间切换，快速模式响应更快但输出质量略低
/btw — 侧边备注：发送一条后台备注作为背景信息补充给模型，不作为主要问题处理
Ctrl+T — 任务视图：查看当前正在进行或排队等待的任务列表
Ctrl+S — 暂存提示词：将当前输入的内容临时保存，方便稍后继续使用
Shift+Enter — 插入换行：在不提交消息的情况下换行，适合输入多行内容
Ctrl+G — 外部编辑器：将当前输入内容发送到系统编辑器（如vim、nano）中编辑，适合编写较长的提示词
启动与运行模式
claude — 启动交互模式
claude "task" — 运行一次性任务后退出
claude -p "query" — 非交互查询后退出（print 模式）
claude -c — 继续最近的对话（保留上下文）
claude -r — 选择并恢复某个历史对话
claude --resume <id> — 恢复指定 ID 的对话
claude update — 升级 Claude Code 到最新版本
claude -r "<session-id>" "query" — 通过指定 ID 恢复会话并继续任务
claude -c -p "query" — 以非交互方式继续最近对话后退出
claude mcp — 配置 MCP 服务器（子命令形式）
--add-dir — 添加额外工作目录（等同于 /add-dir，但在启动时指定）
--agent <name> — 指定本次会话使用的 Agent
--agents '<json>' — 动态定义自定义子 Agent（JSON 格式）
--allowedTools — 指定无需确认即可使用的工具
--disallowedTools — 指定禁止使用的工具
--append-system-prompt — 在默认系统提示后追加内容（保留原有行为）
--system-prompt — 完全替换系统提示词
--system-prompt-file — 从文件加载系统提示词（仅 print 模式）
--permission-mode <mode> — 启动时指定权限模式（如 plan）
--max-turns <n> — 限制非交互模式的最大轮次
--output-format <format> — 指定输出格式（text / json / stream-json）
--fork-session — 恢复会话时创建新 session ID 而非复用原有
--session-id <uuid> — 指定本次会话的 UUID
--mcp-config <file> — 从 JSON 文件加载 MCP 服务器配置
--strict-mcp-config — 仅使用 --mcp-config 指定的 MCP，忽略其他配置
--plugin-dir <path> — 为本次会话加载指定目录的插件
--fallback-model <model> — 主模型过载时自动回退到指定模型
--json-schema '<schema>' — 约束输出为符合 JSON Schema 的结构（仅 print 模式）
--debug — 启用调试模式（可过滤类别，如 "api,hooks"）
--betas — 启用 Beta 功能头（仅 API key 用户）
--ide — 启动时自动连接 IDE
--version / -v — 查看版本号
--worktree / -w — 在隔离的 git worktree 中启动
配置与设置
/config — 打开配置面板
/model — 设置 AI 模型
/permissions — 管理工具权限规则
/output-style — 设置输出样式
/theme — 更换主题
/vim — 切换 Vim/普通编辑模式
/statusline — 设置状态栏界面
/terminal-setup — 安装 Shift+Enter 键绑定
/keybindings — 创建或编辑 ~/.claude/keybindings.json 自定义快捷键
项目与工作区
/init — 初始化 CLAUDE.md 文件
/add-dir — 添加新的工作目录
/memory — 编辑 Claude 记忆文件
/todos — 列出当前待办事项
/plan — 查看当前会话计划
/tasks — 列出并管理后台任务
对话管理
/clear — 清空对话历史并释放上下文
/compact — 清空历史但保留摘要
/resume — 恢复某个对话
/rewind — 回滚版本
/export — 导出当前对话
/context — 可视化上下文使用情况
/insights — 生成 HTML 格式的使用习惯分析报告（保存至 ~/.claude/usage-data/report.html）
集成与扩展
/mcp — 管理 MCP 服务器
/hooks — 管理工具事件钩子
/plugin — 管理插件
/agents — 管理智能体配置
/skills — 列出可用技能
/ide — 管理 IDE 集成
/fast — 开启 Fast 模式（以更高 token 成本换取更快速度）
GitHub & 代码审查
/install-github-app — 设置 Claude GitHub Actions
/pr-comments — 获取 PR 评论
/review — 审查拉取请求
/security-review — 对待定更改进行安全审查
状态与监控
/status — 显示 Claude Code 整体状态
/stats — 显示使用统计与活动
/cost — 显示当前会话费用与时长
/usage — 显示计划使用限制
/doctor — 诊断安装与设置其他平台
/chrome — Chrome 中的 Claude 设置
/install-slack-app — 安装 Slack 应用
/mobile — 显示二维码下载移动应用
帮助与系统
/help — 显示帮助与可用命令
/release-notes — 查看版本发布说明
/stickers — 订购贴纸
/exit — 退出 REPL
管道与自动化
cat file | claude -p "query" — 将文件内容传入 Claude
claude -p "query" --output-format json — 输出 JSON 格式（适合脚本解析）
claude --no-interactive — 强制非交互模式（CI/CD 流水线中使用）
技巧
并行做更多事情
同时启动 3–5 个 git worktree，每个 worktree 里各自运行一个 Claude 会话。这是提升生产力最大的一个杠杆，也是团队给出的头号建议。
Boris 透露，他个人用的是多个 git checkout，但 Claude Code 团队里的大多数人更偏爱 worktree —— 这也是为什么Anthony Morris（CC团队的一名成员）会在 Claude Desktop 应用里为它们做原生支持。
有些人会给 worktree 命名，并设置 shell 别名（比如 za、zb、zc），这样就能一键在不同 worktree 之间切换。还有人会专门留一个“analysis”用的 worktree，只用来读日志、跑 BigQuery。
相关文档： code-sessions-with-git-worktrees
计划模式处理复杂任务
把精力都投入到“计划”阶段，这样 Claude 才有可能一次性（1-shot）完成实现。
团队中有一个人的工作流是：先让一个 Claude 写计划，然后再启动第二个 Claude，站在 staff engineer 的视角来做评审。
另一位成员则表示，只要事情一开始跑偏，就立刻切回 plan mode，重新规划，不要硬推。他们还会明确要求 Claude 在验证步骤中进入 plan mode，而不仅仅是在构建阶段。
重视CLAUDE.md
每次纠错之后，都以这句话结尾：“更新你的 CLAUDE.md，这样你下次就不会再犯这个错误。”
Claude 在给自己写规则这件事上，表现得异常好。
要对 CLAUDE.md 进行毫不留情的编辑和精炼。不断迭代，直到你能可量化地看到 Claude 的错误率明显下降。
有位工程师会让 Claude 为每个任务 / 项目维护一个 notes 目录，每次 PR 之后都会更新，然后在 CLAUDE.md 里指向这个目录。
创建自己的技能
来自团队的一些建议：
- 如果一件事你每天要做不止一次，就把它做成一个 skill 或命令
- 构建一个 /techdebt 的斜杠命令，在每次会话结束时运行，用来找出并清理重复代码
- 设置一个斜杠命令，把最近 7 天 的 Slack、GDrive、Asana、GitHub 同步成一个统一的上下文 dump
- 构建“分析工程师风格”的 agent：自动写 dbt model、做代码审查、并在 dev 环境里测试改动
让Claude 自行修复bug
启用 Slack MCP，然后把 Slack 里的 bug 讨论串直接粘给 Claude，只说一句 “fix” 就行了，完全不需要在不同工具之间来回切换。
或者，直接告诉它：“去把失败的 CI 测试修好。” 不要事无巨细地教它怎么做。
把 docker 日志 指给 Claude，让它排查分布式系统的问题——在这方面它的能力出乎意料地强。
提升你的提示词水平
a. 主动挑战 Claude。
比如对它说：“就这些改动狠狠拷问我，在我通过你的测试之前不要提 PR。” 把 Claude 当成你的 reviewer。 或者说：“向我证明这东西是可行的。” 让 Claude 对比 main 和你的 feature branch 的行为差异。
b. 对一个平庸的修复方案，可以这样说：
“在你已经知道所有这些信息的前提下，把这个方案推倒重来，实现一个更优雅的解法。”
c. 在交付工作前，先写清晰、详细的规格说明，尽量消除歧义。
你给得越具体，产出的质量就越高。
终端与环境配置
团队里很多人都很喜欢 Ghostty，不少人特别看重它的同步渲染、24 位真彩色以及完善的 Unicode 支持。
为了更方便地同时“调度”多个 Claude，可以用 /statusline 自定义状态栏，让它始终显示上下文使用情况和当前 git 分支。团队中还有不少人会给终端标签页做颜色区分、命名，有时会配合 tmux 使用——一个任务 / 一个 worktree 一个标签页。
多用语音输入。你说话的速度大约是打字的 3 倍，而且因此写出来的 prompt 往往更详细（macOS 上按两次 fn 即可）。
使用 subagents
a. 在任何你希望 Claude 投入更多算力的问题后面，加上一句 “use subagents”。
b. 把具体的子任务分配给 subagents，这样可以让主 agent 的上下文窗口保持干净、专注。
c. 通过 hook 把权限请求路由给 Opus 4.5，让它负责扫描潜在攻击，并自动批准安全的请求。
用 Claude 学习
a. 在 /config 里启用 “Explanatory” 或 “Learning” 输出风格，让 Claude 在改代码时解释为什么这么改，而不只是改了什么。
b. 让 Claude 生成一个 可视化的 HTML 演示文稿，用来讲解你不熟悉的代码——它做出来的幻灯片质量出奇地好。
c. 让 Claude 用 ASCII 图 画出新的协议或代码库结构，帮助你建立整体理解。
d. 构建一个间隔重复学习 skill：你先讲述自己的理解，Claude 通过追问来补齐知识盲区，并把最终结果存下来。
xxx
xxx
xxx
xxx
实践
多开命令行
- 使用Cursor或者VS Code作为IDE，安装官方插件，保证Claude Code可以和IDE协同。
- 安装之后，你的Cursor右上角会出现Claude Code的图标。
- 点击图标，会在Cursor文件编辑区打开Claude Code，并且显示一个绿色的状态 IDE connected。
- 可以把命令行拖到下面的终端面板，可以多个命令行一起看。
请注意： 虽然可以同时打开多个，但只有你最后打开的那一个，可以和IDE保持协同。 保持和IDE协同的那一个，会出现绿色的小圈和IDE connected 一般来说，我会让保持和IDE协同的那个，做我不太确认的任务，这样中途我可以参与review代码。
权限授予
claude --dangerously-skip-permissions
会自动打开Bypassing Permissions模式， 此时，Claude Code的右下角会出现黄色的字。
快捷提示词："我想要在终端输入claude 等同于输入 claude --dangerously-skip-permissions ,你帮我设置好"
让CC更努力
官方文档告诉我们，一共有这些词："think" < "think hard" < "think harder" < "ultrathink" 可以加速Claude Code 思考。 稍微复杂一点的任务，都在结尾加上 ultrathink，即可让Claude Code更努力的思考、不受任何预算限制、更尽情地消耗Token。
1+1等于多少？ultrathink
浏览器MCP
context7是必装的MCP，因为它可以补齐「大模型的知识库有cut off截止时间」这个问题，总是引入最新的代码库知识。
如果你要装第二个，我推荐装browsermcp，它可以让你的Claude Code/Cursor 直接打开你的浏览器去查看内容！。
让它能够看到我们的网站产品运行起来的样子，找到差异，从而更有效率地写界面类型和交互类型的代码逻辑。
历史聊天记录
使用 /resume 可以看到所有聊天记录。还可以选择一个（输入数字、或者回车），继续聊天
Ctrl + R - 历史记录搜索别再重复打字了。按 Ctrl + R 可以搜索你过去输入过的 Prompt，再次按下可循环选择，按 Tab 编辑，按 Enter 执行。
图片处理
CC 虽然跑在命令行里面，但是可以向对话中添加图片！
- 将图片拖放到 Claude Code 窗口中。
- 复制图片，然后使用 Ctrl + V 将其粘贴到 CLI 中（不是 Cmd + V）。
- 向 Claude 提供图片路径。 例如：“根据截图结果：/path/to/your/image.png 调整样式，使用 Puppeteer 截图对比设计稿，直到匹配设计稿 ”
极速引用上下文
@ Mentions - 极速引用上下文就像在 Slack 里一样，使用 @ 快速把文件、目录或 MCP 工具拉入上下文
- @src/auth.ts（引用文件）
- @src/components/（引用整个目录）
- @mcp:github（调用 GitHub 工具）
指尖的魔法!
! 前缀 - 瞬间执行 Bash别问 Claude “能不能运行 git status”。直接输入 ! git status。! 前缀会让命令立即在 Shell 中执行，无需模型思考，既省 Token 又省时间。
Prompt 暂存
Ctrl + S把当前的提示词A暂存，可以重新输入新的提示词B，运行完B之后，命令行自动填充回A。
断电恢复
- claude --continue：立即恢复上一次的对话。
- claude --resume：从历史会话列表中选择并恢复。
给会话起个名
- /rename api-migration：重命名当前会话。
- /resume api-migration：按名称恢复。
vim
Vim 模式不想把手移开键盘？输入 /vim 开启 Vim 编辑模式，用 hjkl 导航，用 dd 删除，用 ciw 修改单词。再次输入 /vim 即可退出。
ccusage
ccusage session # 按会话分组查看
ccusage daily # 按天查看
ccusage monthly # 按月查看
ccusage blocks --live # 实时查看 5 小时计费窗口参考文档
Anthropic 社区负责人连更31条Claude Code技巧！
阿里带你1分钟上手基于Claude Code的AI代码评审实践
Claude Code 从入门到精通，通过实战项目穿插 Agent Skills、MCP、Hooks、子代理、插件等十五个知识点
Anthropic内部高阶玩法曝光！旧金山一大牛亲测Claude Code改变产品开发的3大最佳实践总结
Claude Code 遭深度逆向！核心技术架构被 95% 还原
Claude Code 深度拆解：一个顶级AI编程工具的核心架构
everything-claude-code：一套可复用的 Claude Code 工程工作流组件库
黑客松冠军开源ClaudeCode配置指南，几天内15k star
多智能体并行协作开发模式 Claude Code Agent Teams 完整上手攻略
揭秘 Claude Code 前沿技巧与 Qoder CLI 日常开发实战
Anthropic内部神器曝光！这个CLAUDE.md文件，让普通程序员直接变身10x工程师
用 ClaudeCode 实现自动化 Code Review 的探索
AI编程实践：从 Claude Code 到团队协作的 6 个落地抓手
一个 CLAUDE.md，让 AI 真正懂你的项目：从配置到长期提效的完整指南
Claude Code Figma：AI 画原型完整教程，从 PRD 到设计稿只要 5 分钟