没有找到相关内容

Claude Code

Anthropic 推出的命令行 AI 编程助手。它不仅能回答问题,更能直接执行文件读写、运行测试、搜索代码及执行终端命令。

1. 基础启动

在终端 (Terminal) 中输入以下命令启动 Claude。

交互模式 (最常用)
claude
单次任务模式
claude "帮我重构 main.py"

2. 命令速查表 (Cheat Sheet)

Claude Code 全量指令速查。所有命令均在此汇总。

启动与环境 (CLI)

命令 / 参数 说明
claude 启动交互模式
claude "cmd" 单次执行模式 (One-shot)
claude update 升级到最新版本
claude doctor 环境诊断与修复
--print-config 打印当前配置
--verbose 调试模式 (输出详细日志)
--dangerously-skip-permissions 跳过所有权限确认 (慎用)
--version / --help 查看版本 / 显示帮助
--mcp-server [cmd] 临时运行 MCP 服务器
--init 初始化项目配置 (CLI模式)
--non-interactive 非交互模式 (CI/CD用)

交互指令 (Slash Commands)

指令 说明
/ask 仅提问,不修改文件
/edit 修改文件或代码
/search 搜索代码片段
/terminal 执行 Shell 命令
/bug 提交 Bug 反馈
/compact 压缩上下文 (节省 Token)
/reset 重置会话
/cost 查看费用消耗
/files 查看已读文件列表
/mcp 管理 MCP 工具连接
/init 初始化 CLAUDE.md
/tokens 查看 Token 使用情况
/help 查看所有可用指令
/undo 撤销上一次文件修改
/diff / /commit 查看差异 / 提交更改
/review [path] 代码审查与优化建议
/sandbox 进入安全隔离模式
/agents 管理子代理任务
/bashes 管理后台运行的终端任务

配置管理 (Config & Auth)

命令 说明
claude login 登录账号
claude logout 登出账号
claude whoami 显示当前用户信息
claude config list 列出所有配置
claude config set [key] [val] 设置配置项 (如 theme, editor)
claude config set analytics false 关闭匿名统计
claude mcp add [name] [cmd] 添加 MCP 服务器
claude mcp list 查看 MCP 列表
claude mcp remove [name] 移除 MCP 服务器
claude mcp serve 将 Claude Code 作为 MCP 服务运行

快捷键 (Shortcuts)

按键 功能
Esc Esc 倒回 (Rewind)
Shift + Tab 切换计划模式 (Plan Mode)
Ctrl + B 后台运行任务
Ctrl + C 停止生成 / 中断
Ctrl + L 清屏
Ctrl + O 打开浏览器记录
! [cmd] 即时 Shell 模式
Ctrl + R 搜索历史命令
Ctrl + U / Ctrl + W 删除整行 / 删除单词
Tab / ↑ ↓ 自动补全 / 历史翻页
@ 触发文件路径自动补全

高级诊断 (Advanced)

命令 说明
claude doctor --fix 自动修复问题
claude doctor --network 测试网络延迟
ls -R / grep_search (内置) 递归列出文件 / 全局搜索
read_file / write_to_file (内置) 读写文件能力
bash / edit_file (内置) 执行 Shell / Diff 编辑

3. 交互模式工作流

掌握 Claude 的交互模式,不仅是输入命令,更是与 AI 结对编程的艺术。

核心工作流

⚡ TDD (测试驱动开发) 模式

最佳实践是先让 Claude 运行测试,报错后再修复:

  1. 使用 /terminal npm test 运行测试,确保其失败。
  2. 使用 /edit 让 Claude 读取报错并修复代码。
  3. 再次运行测试验证修复结果。

精准控制

  • /ask vs /edit: 不确定时先用 /ask 询问方案,确定方案后再用 /edit 执行修改,避免 AI 乱改代码。
  • /search: 当你不确定文件路径时,先用 /search 查找关键词,Claude 会自动分析相关代码片段。

调试与提交

遇到报错直接输入 /bug,Claude 会自动读取最近的报错堆栈并分析原因。修改完成后,使用 /commit 自动生成符合 Conventional Commits 规范的提交信息。

4. 上下文与成本控制

Claude 的上下文窗口是有限的 (且昂贵的)。高效管理上下文是进阶用户的必修课。

Context Window 管理

随着对话深入,Context 会越来越大,导致响应变慢且消耗更多 Token。使用 /compact 可以智能压缩历史记录,保留关键信息的同时释放空间。

💰 成本控制技巧
每次对话前使用 /files 检查当前读取了哪些文件。不相关的大文件应添加到 .claudeignore 中,防止消耗大量 Token。

随时使用 /cost 查看当前会话的累积消费。

持久化记忆

在项目根目录创建 CLAUDE.md,写入项目的架构规范、代码风格或常用指令。Claude 每次启动都会自动读取此文件,相当于给它植入了“长期记忆”。

会话重置

当 AI 陷入死循环或理解偏差过大时,不要恋战,直接使用 /reset 重置会话,或使用 /undo 撤销最近一次误操作。

5. 配置与环境详解

通过命令行参数与配置文件,定制你的 Claude Code 开发环境。

项目初始化

在接手新项目时,推荐使用 --init 参数。它会引导你配置 CLAUDE.md 和 `.claudeignore`,类似于 npm init,快速建立项目规范。

claude --init

CI/CD 集成

Claude 支持在 GitHub Actions 或 GitLab CI 中运行。使用 --non-interactive 模式可禁用交互提示,配合 --dangerously-skip-permissions 实现全自动代码审查或重构。

claude --non-interactive --dangerously-skip-permissions -p "Review PR #123"

MCP 服务集成

Model Context Protocol (MCP) 让 Claude 能连接数据库、GitHub、Slack 等外部工具。使用 claude mcp add 命令连接新的 MCP Server。

6. 脚本与自动化集成

Claude Code 的真正威力在于它能与你的 Shell 工具链无缝结合。

管道模式 (Piping)

你可以将任何命令的输出 (stdout) 直接“喂”给 Claude 进行分析,无需手动复制粘贴。

# 分析日志错误 cat server.log | claude "找出并修复所有 Error" # 解释代码差异 git diff | claude "生成 Release Note"

自定义指令 (Custom Commands)

.claude/commands/ 目录下创建 Markdown 文件,即可定义专属于你的 Slash 命令。

示例:自定义安全审计指令
创建 .claude/commands/security.md,写入你的审计 Prompt。之后只需输入 /security 即可触发全套审计流程。

JSON 结构化输出

编写脚本时,使用 --output-format json 让 Claude 输出便于程序解析的 JSON 数据,从而实现工具链的自动化串联。

7. 专家级技巧

掌握了基础与自动化后,这些技巧将帮助你榨干 Claude 的每一分潜力。

安全隔离 (Sandbox)

当处理不受信任的代码或执行高风险操作时,使用 /sandbox 进入隔离环境。所有文件修改和命令执行都将在虚拟容器中进行,确保宿主机安全。

并发工作流 (Git Worktree)

⚡ 双线并行

不要让 AI 等你,也不要等你等 AI。在两个终端 Tab 中开启不同的 Git Worktree

  • Tab A (Repair): claude "修复 Bug #101"
  • Tab B (Feature): claude "开发新功能 Login"

物理隔离,互不干扰,效率翻倍。

Shell 极速别名

~/.zshrc.bashrc 中添加别名,跳过繁琐的确认:

alias c="claude --dangerously-skip-permissions" alias ci="claude --init"

环境诊断

遇到奇怪的 EACCES 或网络超时?直接运行 claude doctor --fix,它能自动修复大部分权限和依赖问题。