永无岛
约定：$ 行在系统终端里跑，/ 开头的在 Claude Code 对话框里跑，# 是注释不用复制，<...> 是占位符要换成你自己的值。
一、安装 / 升级 / 卸载
按操作系统选一条命令即可。国内脚本下载慢时切到 npm + 镜像。
# macOS / Linux 一键
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
# macOS Homebrew
brew install --cask claude-code
# Windows WinGet
winget install Anthropic.ClaudeCode
# npm（前端开发者）
npm install -g @anthropic-ai/claude-code
# 国内 npm 镜像
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
# 升级到最新
claude update
# 回滚（保留最近 3 版，新版有 bug 时救命）
claude rollback
# 查看版本
claude --version
# 一键体检（网络、登录、依赖、权限、磁盘）
claude doctor
# macOS / Linux 卸载
~/.claude/bin/uninstall.sh
# 完全清理残留
rm -rf ~/.claude ~/.claude-code-router ~/.claude.json
二、登录 / 配置 / 状态
三种登录方式：Anthropic 订阅、API Key、企业 SSO。首次运行 claude 会弹浏览器走 OAuth；服务器上没图形界面时加 --no-browser。
# 启动并登录（首次弹浏览器）
claude
# 强制重新登录
claude logout && claude login
# 服务器 / SSH 环境登录
claude login --no-browser
# 用 API Key 登录
claude login --api-key sk-ant-xxx
# 查看 / 修改本机配置
claude config list
claude config set <key> <value>
claude config unset <key>
# 在对话框里查看账户与订阅档位
/status
# 切换账户
/login
# 优雅退出（Ctrl+D 也行）
/exit
三、模型管理
2.x 起默认 Sonnet 4.5（性价比最佳），更强推理切 Opus，更便宜更快切 Haiku。
# 在对话框里切模型（也支持简写 sonnet / opus / haiku）
/model claude-sonnet-4-5
/model claude-opus-4-7
/model claude-haiku-4-5
# 不带参数：弹可选菜单
/model
# 命令行单次指定模型
claude --model opus "请评审这段代码"
claude --model haiku "用一句话总结这篇文章"
# 设默认模型
claude config set model claude-sonnet-4-5
四、会话管理
掌握这几个键位与命令，能省一半 token、少 80% 崩溃。长任务跑半小时后用一次 /compact。
# 中断当前操作（Claude 在思考或跑工具时）
按 Esc
# 强制退出
Ctrl + C
# 清空当前会话（从零开始）
/clear
# 压缩对话历史（token 能降到 1/5）
/compact
# 压缩时附加自定义指令
/compact 只保留与数据库 schema 相关的部分
# 看本次会话花费
/cost
# 看本月累计用量
/status
# 列出所有历史会话
claude resume --list
# 恢复某次会话（1 = 最近一次）
claude resume <session-id>
claude resume 1
# 在项目目录里启动并接续历史
cd /path/to/project && claude --continue
五、CLAUDE.md 与记忆
CLAUDE.md 是 Claude Code 的"长期大脑"，分三层：全局个人 / 项目共享 / 个人项目覆盖，启动时按层级合并加载。
# 在当前项目里自动生成 CLAUDE.md（第一次用就跑）
/init
# 查看已加载的所有 CLAUDE.md（含合并效果与冲突）
/memory
# 在对话里临时加一条记忆
/memory add 这个项目用 pnpm，不要建议 npm install
# 直接编辑 CLAUDE.md（弹 $EDITOR）
/memory edit
# 三层记忆文件位置
~/.claude/CLAUDE.md # 全局个人，所有项目都生效
./CLAUDE.md # 项目共享，建议提交到 git
./.claude/CLAUDE.md # 项目共享（备选位置）
./.claude/CLAUDE.local.md # 个人项目覆盖，不进 git
六、文件引用与操作
@ 是 Claude Code 最重要的输入语法。它告诉 Claude："请把这个文件 / 目录 / 行段 / git 改动真正读进来再回答。" 不加 @ 时 Claude 会"靠想象回答"。
# 引用单个文件
请改进 @src/api/user.ts
# 引用整个目录（Claude 按需挑文件读）
请评审 @src/components/
# 引用特定行段（节省 token，强烈推荐）
请解释 @main.py:42-65
# 引用最近一次 git 提交
请 review @git:HEAD
# 引用某次提交（hash 前 7 位）
请总结 @git:a1b2c3d 这次改动的影响
# 引用分支差异
请评审 @git:main..feature/login
# 引用未提交的改动
请帮我写 commit message：@git:staged
请帮我评审：@git:unstaged
# 引用粘贴板 / URL / 图片
请整理 @clipboard
请总结 @https://example.com/article
@screenshot.png 这张图里的报错是什么意思？
七、内置 Slash Commands（30+ 条）
斜杠命令在对话框里输入。自定义命令放在 ~/.claude/commands/ 或 ./.claude/commands/，写一个 markdown 文件就自动注册。
/init # 初始化项目，自动生成 CLAUDE.md
/clear # 清空当前会话上下文
/compact # 压缩对话历史
/help # 查看所有命令
/status # 账户、订阅档位、本月用量
/cost # 本次会话花费
/model # 切换 / 查看当前模型
/login /logout # 重新登录 / 退出登录
/config # 编辑 settings.json
/permissions # 查看 / 修改权限模式
/memory # 查看 / 编辑 CLAUDE.md 加载情况
/agents # 管理 Subagents
/hooks # 管理 Hooks
/mcp # 管理 MCP Servers
/skills # 管理 Skills
/loop # 管理定时任务（Cron）
/review # PR 评审（需装 GitHub MCP）
/diff # 查看本次会话产生的所有变更
/plan # 切换 / 强制进入 Plan Mode
/voice # 切换语音模式
/computer-use # 启用 Computer Use（屏幕控制）
/audit # 查看本次会话所有工具调用审计
/ide # 在 VS Code / JetBrains 里打开
/web # 启动浏览器版 Web 界面
/resume # 恢复历史会话
/feedback /bug # 给 Anthropic 提反馈 / 提 bug
/release-notes # 查看当前版本更新日志
/share # 当前会话生成可分享链接
/exit # 优雅退出
八、Subagents 管理
Subagent 是 Claude Code 的并行执行单元——主对话不卡，子任务后台跑，能同时处理 20+ 个并行任务。新人建议从 /agents create 向导走一遍。
/agents list # 列出所有
/agents create <name> # 用向导创建
/agents edit <name> # 编辑提示词与工具权限
/agents remove <name> # 删除
/agents ps # 看正在跑的实例
/agents kill <id> # 杀掉正在跑的
/agents wait <id> # 等待跑完（脚本里有用）
/agents run <name> "<任务>" # 立即跑一次
# 配置文件位置
~/.claude/agents/<name>.md # 全局
./.claude/agents/<name>.md # 项目
九、MCP（Model Context Protocol）管理
MCP 让 Claude Code 能调外部服务——数据库、邮件、Notion、Slack、GitHub、浏览器、Figma……官方与社区已有 200+ 个 Server。
/mcp list # 列出已装（状态 running/stopped/error）
/mcp add <name> # 添加（向导式，写入 .mcp.json）
/mcp restart <name> # 重启（卡住时用）
/mcp tools <name> # 看暴露的工具
/mcp call <server>.<tool> '{...}' # 调用某个工具（调试）
/mcp remove <name> # 删除
/mcp disable <name> /mcp enable <name>
# 一行命令快速添加
claude mcp add github -- npx -y @modelcontextprotocol/server-github
# 配置文件位置
./.mcp.json # 项目级，团队共享
~/.claude/mcp.json # 全局个人
# 日志（排查连接问题）
~/.claude/logs/mcp/<name>.log
十、Hooks 管理
Hooks 是"事件钩子"——Claude 一旦触发某个事件（要跑工具、写文件、用 Bash、会话结束等），先跑你定义的脚本。可以给 Claude 加一道"安全门"或"自动化反射弧"。
# 配置文件位置（按优先级从高到低）
.claude/settings.local.json # 项目级，仅本机
.claude/settings.json # 项目级，团队共享
~/.claude/settings.json # 全局个人
# 在对话框里
/hooks list # 查看已配置
/hooks add # 用向导添加
/hooks disable <name> # 临时禁用
/hooks enable <name> # 启用
/hooks logs <name> # 看执行日志
/hooks test <name> # 模拟跑一次（不真触发）
# Hook 触发时的环境变量（写脚本可读）
$CLAUDE_PROJECT_DIR # 当前项目路径
$CLAUDE_TOOL_NAME # 触发的工具名
$CLAUDE_TOOL_INPUT # 工具入参（JSON）
$CLAUDE_SESSION_ID # 会话 ID
# 事件类型
PreToolUse / PostToolUse # 工具调用前后
UserPromptSubmit # 用户输入提交后
SessionStart / SessionEnd # 会话开始 / 结束
Stop / SubagentStop # 主对话 / 子代理结束
Notification # 通知发出前
十一、Skills 管理
Skill 是"按需加载的小专家"——只在 Claude 判断"用得上"时才加载，平时不占上下文。一个 Skill 是一个文件夹，含 SKILL.md 和辅助脚本 / 模板。
/skills list # 列出（本地+个人+项目+市场已订阅）
/skills info <name> # 详情（含触发关键词、引用文件）
/skills enable <name> # 启用
/skills disable <name> # 禁用
/skills invoke <name> # 强制调用（绕过自动判定）
/skills install <market-id> # 从市场安装
/skills remove <name> # 卸载
# Skill 目录位置
./.claude/skills/<name>/SKILL.md # 项目级
~/.claude/skills/<name>/SKILL.md # 全局个人
# 校验 frontmatter
claude skills lint <path>
十二、定时任务（/loop）
/loop 用 Cron 表达式定义"什么时间点"自动跑提示词。本质是给 Claude 设了一个闹钟——闹钟一响，Claude 自己醒来执行任务，结果可以发邮件、推微信、写文件。
# 创建（cron + 提示词）
/loop "0 8 * * *" "请生成今日早报，含天气、新闻、日程"
# 指定模型与超时
/loop "0 8 * * *" --model opus --timeout 10m "..."
/loop list # 列出所有
/loop show <id> # 查看详情
/loop disable <id> # 暂停
/loop enable <id> # 启用
/loop remove <id> # 删除
/loop logs <id> [--tail 50] # 看执行日志
/loop run <id> # 立即跑一次（调试用）
/loop edit <id> # 编辑 cron 或提示词
# 配置文件
~/.claude/loops/<id>.yaml
十三、CRON 表达式速查
CRON 是定时任务的"标准化时间语言"，五个字段从左到右分别表示"分 / 时 / 日 / 月 / 星期"。背下结构图就够 99% 的场景。
* * * * *
│ │ │ │ │
│ │ │ │ └── 星期 (0-7, 0/7 = 周日)
│ │ │ └──── 月 (1-12)
│ │ └────── 日 (1-31)
│ └──────── 时 (0-23)
└────────── 分 (0-59)
# 高频用法
"0 8 * * *" # 每天 8:00
"*/30 * * * *" # 每 30 分钟
"0 */2 * * *" # 每 2 小时（整点）
"0 9 * * 1-5" # 工作日 9:00
"0 17 * * 5" # 每周五 17:00
"0 22 1 * *" # 每月 1 号 22:00
"0 9-18 * * 1-5" # 工作日 9-18 点每小时
"0 0 * * 0" # 每周日凌晨
"*/5 9-18 * * 1-5" # 工作日工作时段每 5 分钟
# 特殊别名
@yearly @monthly @weekly @daily @hourly @reboot
# 强制时区（默认跟系统）写在 ~/.claude/settings.json
{ "loop": { "timezone": "Asia/Shanghai" } }
十四、环境变量
最常用两个：ANTHROPIC_API_KEY（API Key 登录）和 ANTHROPIC_BASE_URL（走中转或自建网关）。其余都是企业部署、网络代理、调试时才用。
# Anthropic 官方 API Key
export ANTHROPIC_API_KEY="sk-ant-xxx"
# 国内中转网关
export ANTHROPIC_BASE_URL="https://api.your-relay.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxx"
# AWS Bedrock（企业）
export ANTHROPIC_BEDROCK=1
export AWS_REGION=us-east-1
# Google Vertex AI（企业）
export ANTHROPIC_VERTEX=1
export GOOGLE_CLOUD_PROJECT=your-project
# Azure Foundry（企业）
export ANTHROPIC_FOUNDRY=1
# HTTP 代理
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
# 配置目录 / 关遥测 / 关自动更新
export CLAUDE_CONFIG_DIR="$HOME/.claude"
export CLAUDE_DISABLE_TELEMETRY=1
export CLAUDE_DISABLE_AUTO_UPDATE=1
# 默认模型 / 最大并行 Subagent 数
export CLAUDE_DEFAULT_MODEL=claude-sonnet-4-5
export CLAUDE_MAX_PARALLEL_AGENTS=5
# 永久写到 shell
echo 'export ANTHROPIC_API_KEY="sk-ant-xxx"' >> ~/.zshrc && source ~/.zshrc
# Windows 永久（PowerShell）
# [Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','sk-ant-xxx','User')
十五、Plan Mode / Accept Edits / Default 切换
Claude Code 有三种"权限模式"，按 Shift + Tab 一键循环切换。新人最容易踩坑的就是没看清当前模式——以为只是"聊聊天"，结果文件已经被改了。
# 三种权限模式
Default # 每次工具调用都问一次
Plan Mode # 只规划不执行，安全
Accept Edits # 改文件都不再问，效率高但风险也高
# 一键循环切换
按 Shift + Tab
# 查看当前模式
/permissions
# 强制进入 Plan Mode
/plan
# 强制退出 Plan Mode
/plan off
# 临时把权限放宽到 Accept Edits（一次性）
/permissions --mode accept-edits
# 给某个工具单独授权 / 拉黑
/permissions allow Bash
/permissions deny WebFetch
# 把权限规则写到配置（团队共享）
# .claude/settings.json
{
"permissions": {
"allow": ["Read", "Edit", "Bash(git*)"],
"deny": ["Bash(rm*)", "WebFetch"]
}
}
十六、调试与日志
跑出问题先看日志。claude doctor 是排错瑞士军刀。
# 调试 / 详细模式
claude --debug
claude --verbose
# 单条命令开启调试
claude --debug "请读这个文件 @main.py"
# 一键体检
claude doctor
# 日志路径
~/.claude/logs/ # 总目录
~/.claude/logs/session-latest.log # 当次会话（tail -f 看实时）
~/.claude/logs/mcp/<server-name>.log # MCP Server
~/.claude/logs/hooks/ # Hook 执行
~/.claude/logs/errors/ # 崩溃信息（提 bug 时附上）
~/.claude/projects/ # 每个项目的会话快照
~/.claude/shell-snapshots/ # Hook 跑过的 shell 历史
# 清理 30 天前日志
find ~/.claude/logs -type f -mtime +30 -delete
# 打包发给 Anthropic 排查
tar -czf claude-logs.tar.gz ~/.claude/logs/
十七、备份与迁移
~/.claude/ 是 Claude Code 的"全部家当"——配置、记忆、会话历史、Skills、Hooks 都在里面。换电脑、重装系统前一定打个包。
# 完整备份
tar -czf claude-backup-$(date +%Y%m%d).tar.gz ~/.claude/
# 仅备份配置（最小集）
tar -czf claude-config.tar.gz \
~/.claude/settings.json \
~/.claude/CLAUDE.md \
~/.claude/agents/ ~/.claude/commands/ ~/.claude/skills/
# 恢复
tar -xzf claude-backup.tar.gz -C ~/
# 项目 CLAUDE.md 单独导出
cp ./CLAUDE.md ~/Desktop/CLAUDE-$(basename $PWD).md
# 用 git 管理配置（推荐）
cd ~/.claude
git init && git add CLAUDE.md settings.json agents commands skills
git commit -m "init"
git remote add origin <你的私有仓库> && git push -u origin main
# 一行迁移到新设备
rsync -avz ~/.claude/ new-machine:~/.claude/
十八、ccusage（社区成本统计）
ccusage 是社区维护的成本统计工具，比 /cost 更详细——按天 / 按月 / 按模型 / 按项目分组，还能导出 CSV。订阅用户也能用，看到的是"按 API 计价该花多少"，方便判断订阅划不划算。
# 安装
npm install -g ccusage
# 看每日 / 每周 / 每月
ccusage daily
ccusage weekly
ccusage monthly
# 按模型 / 项目 / Subagent 分组
ccusage --by model
ccusage --by project
ccusage --by agent
# 指定时间范围
ccusage --from 2026-04-01 --to 2026-04-19
# 实时监控
ccusage watch
# 导出
ccusage monthly --json > usage.json
ccusage monthly --csv > usage.csv
# 设置预算告警（月预算 200 美元）
ccusage budget set 200
ccusage budget
十九、Claude Code Router（国内省钱方案）
@musistudio/claude-code-router（简称 ccr）是社区维护的"模型路由器"，把请求按规则分流到 DeepSeek / GLM / Kimi 等国产模型，能把月成本砍到 1/5。本质是把 Claude Code 当壳，模型换成你想要的。
# 安装
npm install -g @musistudio/claude-code-router
# 启动（替代 claude 命令）
ccr code
# 配置文件（首启自动生成模板）
~/.claude-code-router/config.json
# 查看 / 测试 provider
ccr providers
ccr test deepseek
# 切换默认 provider
ccr config set default-provider deepseek
# 在对话里临时切换
/ccr-model deepseek-v3
/ccr-model glm-4.6
/ccr-model kimi-k2
# 路由日志 / 升级 / 停止
~/.claude-code-router/logs/
npm update -g @musistudio/claude-code-router
ccr stop
二十、紧急救援
跑了危险命令、Token 泄露、Claude Code 卡死、磁盘被填爆——按下面顺序处理，5 分钟内能脱险。
# 杀掉所有 Claude 进程（卡死时第一步）
pkill -f claude
pkill -f "claude-code"
# Windows：Get-Process | ? Name -like "*claude*" | Stop-Process -Force
# 临时去掉 API Key（防止再被扣费）
unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
# 撤销 API Key：登录 console.anthropic.com → Settings → API Keys → Revoke
# 看磁盘是不是被日志撑满
du -sh ~/.claude/*
find ~/.claude/logs -type f -mtime +30 -delete
rm -rf ~/.claude/projects/ # 清空项目历史（不可恢复）
# 撤销刚才被修改的文件（在 git 仓库里）
git status # 先看哪些被改了
git restore <file> # 单文件撤销
git restore . # 全部撤销
git clean -fd # 删除未跟踪文件（先 -nd 预演）
# Claude 改坏了 CLAUDE.md，回滚
git checkout HEAD -- CLAUDE.md
# Key 不慎进了 git commit，从历史里剔除
git filter-repo --replace-text <(echo 'sk-ant-xxx==>***')
# 完全卸载并清理（核选项）
~/.claude/bin/uninstall.sh
rm -rf ~/.claude ~/.claude-code-router ~/.claude.json
# 紧急求助渠道
Anthropic 邮箱：support@anthropic.com
GitHub Issues：https://github.com/anthropics/claude-code/issues
本书勘误：book@claudebook.community
速查口诀
装 ：curl install.sh | bash
登 ：claude → /login
看 ：/status /cost /memory
切 ：Shift+Tab 切模式，/model 切模型
读 ：@文件 @目录 @行段 @git
管 ：/agents /mcp /hooks /skills /loop
救 ：Esc 中断，Ctrl+C 退出，pkill -f claude 清场