从入门到精通，手把手教你玩转两大终端 AI 编程神器！
前面三篇教程带大家完成了安装、卸载、升级的完整闭环。今天这篇是系列的重头戏——使用教程。
安装好工具只是第一步，真正能发挥出它们的威力，需要掌握正确的使用方法。Claude Code 内置了超过 50 个命令，OpenCode 也有一套完整的工作流体系。如果你只会简单地问“帮我写个函数”，那你只用了它们 10% 的能力。
这篇文章会带你深入了解：
- 两大工具的核心命令体系
- 高效的快捷键操作
- 两种工作模式（Plan vs Build）的实战应用
- MCP 服务器配置
- 自定义命令和 Skills 的高级玩法
无论你是刚入门的萌新还是想进阶的老手，这篇都能帮你把工具用到极致！
📋 目录
一、快速上手：5分钟跑通第一个任务
在深入细节之前，先来个快速热身，确保你的环境能正常工作。
1.1 Claude Code 快速验证
# 进入你的项目目录
cd your-project
# 启动 Claude Code
claude
首次启动会提示登录（需要 Claude Pro/Max 订阅），登录后你会看到交互界面。输入：
分析一下这个项目的技术栈
Claude 会自动扫描项目文件，给你一份技术栈报告。能正常返回结果，说明配置成功。
1.2 OpenCode 快速验证
# 进入项目目录
cd your-project
# 启动 OpenCode
opencode
首次启动需要配置模型提供商。运行：
/connect
按提示选择你的模型提供商（OpenAI、Anthropic、本地 Ollama 等），输入 API Key。配置完成后，输入：
@src 分析一下这个项目的技术栈
能正常返回结果，说明配置成功。
1.3 第一次对话的建议
很多新手一上来就让 AI 直接改代码，这是最大的误区。先用 Plan 模式探索，再切 Build 模式执行。
二、Claude Code 核心命令体系
Claude Code 的命令分为三大类：CLI 标志、斜杠命令、键盘快捷键。
2.1 CLI 启动标志
这些命令在启动 Claude Code 时使用：
| claude | 启动标准交互式 REPL | claude |
| claude -p "query" | 打印响应后退出（非交互模式） | claude -p "检查错误" |
| claude -c | 继续最近一次对话 | claude -c |
| claude –add-dir <path> | 添加额外工作目录 | claude –add-dir ../lib |
| claude –model <model> | 指定模型 | claude –model opus |
| claude –verbose | 启用详细日志 | claude –verbose |
实用场景：把日志文件传给 Claude 分析
cat logs/error.log | claude -p "分析这个错误日志，给出修复建议"
2.2 斜杠命令（交互式会话内）
日常核心命令（每天都会用）
| /init | 生成 CLAUDE.md 项目记忆文件 | 新项目第一次使用，让 AI 记住项目规范 |
| /compact | 压缩对话历史，回收上下文空间 | 会话超过 30 分钟，或出现上下文警告 |
| /clear | 硬重置，清空所有对话历史 | 切换到完全不同的任务时 |
| /model | 切换模型（sonnet/opus/haiku） | 简单任务切小模型省 token |
| /cost | 显示当前会话的 Token 消耗和费用 | 每次结束前看看花了多少钱 |
| /context | 显示上下文窗口用量百分比 | 70-80% 时该执行 /compact 了 |
| /memory | 编辑 CLAUDE.md 记忆文件 | 会话中途添加编码规范 |
项目初始化命令
| /config | 修改配置 | 调整权限、行为偏好等 |
| /mcp | 管理 MCP 服务器 | 接入外部工具和数据源 |
进阶命令
| /btw | 不打断上下文的提问 | AI 执行任务时突然想查点东西 |
| /plan | 计划模式（只读） | 复杂任务先规划再执行 |
| /fast | 极速模式 | 需要快速迭代时开启 |
| /fork | 创建实验分支 | 测试高风险重构 |
| /rewind | 回退对话或代码 | 改坏了需要撤销（Esc+Esc 快捷键） |
| /todos | 持久化任务列表 | v2.1.16 新增，跨会话保存任务 |
| /simplify | 代码审查（3个并行 Agent） | 替代已弃用的 /review |
| /help | 显示所有可用命令 | 忘记命令时随手查 |
2.3 模型选择策略
| Sonnet 4.6 | 默认选项，平衡性价比 | 日常编码、重构、Bug 修复 |
| Opus 4.6 | 最强能力，价格较高 | 复杂多步骤规划、架构决策、关键生产代码 |
| Haiku 4.5 | 最快最便宜 | 简单编辑、样板代码生成、快速提问 |
日常策略：Sonnet 起步，遇到瓶颈切 Opus，琐碎任务交给 Haiku。
三、OpenCode 核心命令体系
OpenCode 同样支持丰富的斜杠命令和自定义命令。
3.1 内置斜杠命令
| /init | 生成 AGENTS.md 项目记忆文件 | 新项目第一次使用 |
| /connect | 配置 AI 模型提供商 | 首次使用或更换模型时 |
| /plan | 切换到 Plan 模式（只分析不修改） | 代码审查、性能分析 |
| /build | 切换到 Build 模式（实际修改代码） | 重构、添加功能 |
| /undo | 撤销最近一次修改 | AI 改错了回滚 |
| /redo | 重做撤销的操作 | 恢复误撤销 |
| /share | 生成会话分享链接 | 把对话记录分享给同事 |
| /themes | 更换终端主题 | 个性化设置 |
| /models | 查看/切换可用模型 | 在不同模型间切换 |
| /doctor | 诊断系统配置 | 排查问题 |
3.2 核心设计理念：Plan 与 Build 分离
OpenCode 最核心的设计理念是 Plan 和 Build 两种模式的分离：
- Plan 模式：AI 只分析代码、制定方案，不修改任何文件
- Build 模式：AI 实际执行代码修改
通过 Tab 键可以在两种模式间切换。这个设计让开发者可以：
3.3 @ 引用文件
OpenCode 支持用 @ 符号模糊搜索并引用文件：
请解释 @src/auth/index.ts 里的认证流程
AI 会自动读取文件内容，无需手动复制粘贴。
四、快捷键大全：告别纯打字
4.1 Claude Code 快捷键
| Ctrl+C | 取消当前输入/生成 | AI 跑偏了赶紧刹车 |
| Ctrl+D | 退出会话 | 安全退出 |
| Ctrl+L | 清屏 | 保持界面整洁 |
| Ctrl+R | 反向搜索命令历史 | 快速定位历史输入 |
| Ctrl+O | 切换详细输出模式 | 看 AI 的思考过程 |
| Tab | 切换扩展思考模式 | 复杂任务让 AI 更深入推理 |
| Shift+Tab 或 Alt+M | 切换权限模式 | normal → auto-accept → plan |
| Esc+Esc | 撤销最近文件改动 | 救命键，改坏了一键回退 |
| Shift+Enter | 多行输入换行 | 不发送，继续输入 |
4.2 OpenCode 快捷键
| Tab | 切换 Plan/Build 模式 |
| Ctrl+X + T | 切换主题 |
4.3 多行输入技巧
在终端里输入多行内容，有三种方法：
五、两种工作模式：Plan vs Build
这是两个工具都非常重视的设计理念，但实现方式略有不同。
5.1 Claude Code 的工作模式
Claude Code 有三种模式，通过 Shift+Tab 循环切换：
| Normal | 每次工具执行前要求确认 | 日常使用，有控制感 |
| Auto-Accept | 无需确认直接执行 | 写测试、生成样板代码时 |
| Plan Mode | 只展示方案，审批后才执行 | 配置、数据库迁移、package.json 等关键文件 |
5.2 OpenCode 的工作模式
OpenCode 通过 Tab 键在 Plan 和 Build 之间切换：
Plan 模式示例：
请解释 @src/auth/index.ts 里的认证流程。
先不要修改任何内容。
Build 模式示例（确认方案后）：
现在按照刚才的方案实现认证功能。
5.3 实战建议：复杂任务用 Plan
面对复杂的重构任务，不要一上来就让 AI 动手：
请先分析一下这个项目的架构，然后制定一个重构计划，不要直接改代码。
等确认计划没问题了，再让 AI 分步执行。这样可以避免 AI 在错误的方向上狂奔。
六、高级玩法：MCP 服务器配置
MCP（Model Context Protocol）是让 AI 调用外部工具的能力——数据库、API、浏览器，甚至自定义脚本。
6.1 什么是 MCP？
简单说，MCP 让 AI 能做的事情远超“写代码”：
- 连接 GitHub：查看 PR、创建 Issue
- 连接 PostgreSQL：直接查询数据库
- 连接 Sentry：获取错误日志
6.2 Claude Code 配置 MCP
通过命令行添加 MCP 服务器：
claude mcp add github
启用/禁用服务器：
/mcp
重要：启用 MCP 服务器会消耗上下文窗口。每个服务器会往上下文里添加工具定义，7 个活跃服务器可能吃掉 25% 的上下文。
优化技巧：设置 ENABLE_EXPERIMENTAL_MCP_CLI=true 可以延迟加载工具，减少开销。
6.3 OpenCode 配置 MCP
OpenCode 采用声明式配置，在 opencode.jsonc 中定义：
{
"mcp": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
优势：可以用 glob 模式控制哪些 Agent 能看到哪些工具，避免上下文污染。
6.4 MCP 成本控制建议
如果你连接 1-2 个服务器，两种工具差别不大。但如果要同时连接 GitHub、Sentry、数据库，OpenCode 的按需加载机制能有效控制上下文开销。
七、高级玩法：自定义命令
7.1 Claude Code 自定义命令
在项目的 .claude/commands/ 目录下创建 .md 文件，就能定义自己的命令。
示例：创建 .claude/commands/review-pr.md
请对当前分支的所有改动做一次完整的 Code Review，重点关注：
1. 潜在的安全漏洞
2. 性能问题
3. 代码规范
输出格式用表格，包含文件名、问题描述、严重程度。
之后在 Claude Code 里输入 /review-pr 即可调用。
参数传递：使用 $ARGUMENTS 捕获所有参数，$1、$2 实现位置参数：
# .claude/commands/fix-issue.md
请修复 Issue #$1，相关文件是 $2。
输入 /fix-issue 101 src/auth.ts 即可。
7.2 OpenCode 自定义命令
在 .opencode/commands/ 目录下创建 Markdown 文件。
示例：.opencode/commands/test.md
—
description: Run tests related to the current change
agent: build
—
运行这次 session 里涉及文件的相关测试。
先总结失败，再给出最小可行的修复方案。
之后输入 /test 即可使用。
八、高级玩法：OpenCode Skills
Skills 是 OpenCode 的高级功能，比自定义命令更强大——它允许 Agent 自动发现并调用预定义的工作流。
8.1 Skill 与自定义命令的区别
| 触发方式 | 用户显式输入 /命令名 | Agent 自动发现并调用 |
| 适用场景 | 快速、高频的简单指令 | 多步骤、复杂的工作流 |
| 文件格式 | 单个 Markdown | 目录 + SKILL.md |
8.2 创建 Skill
在 .opencode/skill/<skill-name>/SKILL.md 创建文件：
—
name: git-release
description: Create consistent releases and changelogs
—
## What I do
– Draft release notes from merged PRs
– Propose a version bump
– Provide a copy-pasteable `gh release create` command
## When to use me
Use this when you are preparing a tagged release.
8.3 Skill 权限控制
在 opencode.json 中配置权限：
{
"permission": {
"skill": {
"git-release": "allow",
"internal-*": "deny",
"experimental-*": "ask"
}
}
}
- allow：Agent 可直接使用
- deny：Agent 无法发现该 Skill
- ask：使用时向用户确认
九、实战对比：同一个任务两种工具的表现
9.1 测试任务：跨文件重命名
任务：将代码库中所有 user_id 重命名为 userId（驼峰命名），确保编译通过。
Claude Code 表现（耗时 3 分 6 秒）：
- 重命名了所有代码中的变量
- 保留了 JSDoc 注释，认为注释是独立层，不应修改
OpenCode 表现（耗时 3 分 13 秒）：
- 重命名了所有代码中的变量
- 连注释里的 user_id 也改了，确保 API 文档一致性
谁更好？ 取决于团队规范。如果你的注释会被其他工具解析，OpenCode 更彻底；如果注释是内部笔记，Claude Code 更谨慎。
9.2 测试任务：写单元测试
任务：为 validators.ts 模块编写单元测试。
Claude Code 表现（耗时 3 分 12 秒）：
- 写了 73 个测试用例
- 只验证了新增的测试通过
OpenCode 表现（耗时 9 分 11 秒）：
- 先运行 pnpm install 确保依赖最新
- 执行完整测试套件确保无回归
- 写了 94 个测试用例
总结：Claude Code 追求速度，OpenCode 追求稳健。
9.3 总耗时对比
| 跨文件重命名 | 3m 6s | 3m 13s |
| Bug 修复 | 41s | 40s |
| 代码重构 | 2m 10s | 3m 16s |
| 写测试 | 3m 12s | 9m 11s |
| 总计 | 9m 9s | 16m 20s |
Claude Code 平均快 80%，但 OpenCode 的测试更全面。
十、总结与选型建议
10.1 核心差异速览
| 开源模式 | 闭源商业产品 | MIT 开源 |
| 模型支持 | 仅 Claude | 75+ 提供商 + 本地模型 |
| 核心形态 | CLI 工具 | CLI + 桌面 App + IDE 插件 |
| 订阅要求 | Claude Pro/Max（$20-200/月） | 免费工具，自备 API Key |
| 架构 | 单体 CLI | Client/Server + HTTP API |
| 速度 | ⚡ 更快 | 🛡️ 更稳健全面 |
| 本地模型 | ❌ | ✅ Ollama 原生支持 |
10.2 选型建议
选择 Claude Code 如果：
- 追求极致速度和流畅体验
- 已订阅 Claude Pro/Max，不想额外付费
- 接受闭源生态，不需要自己折腾配置
- 只需要 Claude 模型就够了
选择 OpenCode 如果：
- 想要开源自由，可以查看/修改源码
- 想自由切换模型（GPT-4、Claude、本地模型）
- 需要本地部署保障数据隐私
- 喜欢 Plan/Build 分离的工作流
- 想用 Skills 自定义复杂工作流
- 预算有限，想复用已有 API Key
10.3 终极建议
两个都装！
Claude Code 适合快速迭代、日常编码；OpenCode 适合复杂重构、多模型切换、需要稳健验证的场景。两个工具可以共存，互补使用。
写在最后
恭喜！你已经掌握了 Claude Code 和 OpenCode 的完整使用方法。
核心要点回顾：
工具本身不产生价值，会用工具的人才产生价值。
