终端 AI 编程完全指南：Claude Code 和 OpenCode 深度使用教程

Java_ESS2026-03-26 12:10

从入门到精通，手把手教你玩转两大终端 AI 编程神器！

前面三篇教程带大家完成了安装、卸载、升级的完整闭环。今天这篇是系列的重头戏------使用教程。

安装好工具只是第一步，真正能发挥出它们的威力，需要掌握正确的使用方法。Claude Code 内置了超过 50 个命令，OpenCode 也有一套完整的工作流体系。如果你只会简单地问"帮我写个函数"，那你只用了它们 10% 的能力。

这篇文章会带你深入了解：

  • 两大工具的核心命令体系
  • 高效的快捷键操作
  • 两种工作模式（Plan vs Build）的实战应用
  • MCP 服务器配置
  • 自定义命令和 Skills 的高级玩法

无论你是刚入门的萌新还是想进阶的老手，这篇都能帮你把工具用到极致！

📋 目录

  1. 快速上手：5分钟跑通第一个任务
  2. [Claude Code 核心命令体系](#Claude Code 核心命令体系)
  3. [OpenCode 核心命令体系](#OpenCode 核心命令体系)
  4. 快捷键大全：告别纯打字
  5. [两种工作模式：Plan vs Build](#两种工作模式：Plan vs Build)
  6. [高级玩法：MCP 服务器配置](#高级玩法：MCP 服务器配置)
  7. 高级玩法：自定义命令
  8. [高级玩法：OpenCode Skills](#高级玩法：OpenCode Skills)
  9. 实战对比：同一个任务两种工具的表现
  10. 总结与选型建议

一、快速上手：5分钟跑通第一个任务

在深入细节之前，先来个快速热身，确保你的环境能正常工作。

1.1 Claude Code 快速验证

bash 复制代码 
# 进入你的项目目录
cd your-project

# 启动 Claude Code
claude

首次启动会提示登录（需要 Claude Pro/Max 订阅），登录后你会看到交互界面。输入：

复制代码 
分析一下这个项目的技术栈

Claude 会自动扫描项目文件，给你一份技术栈报告。能正常返回结果，说明配置成功。

1.2 OpenCode 快速验证

bash 复制代码 
# 进入项目目录
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 分析

bash 复制代码 
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 键可以在两种模式间切换。这个设计让开发者可以：

  1. 先用 Plan 模式确认 AI 理解正确
  2. 审查方案无误后，再切 Build 模式执行

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 多行输入技巧

在终端里输入多行内容，有三种方法：

  1. 行尾打 \ 再按 Enter
  2. Option+Enter（macOS）
  3. Shift+Enter（跨平台通用）

五、两种工作模式：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 服务器：

bash 复制代码 
claude mcp add github

启用/禁用服务器：

复制代码 
/mcp

重要：启用 MCP 服务器会消耗上下文窗口。每个服务器会往上下文里添加工具定义，7 个活跃服务器可能吃掉 25% 的上下文。

优化技巧 ：设置 ENABLE_EXPERIMENTAL_MCP_CLI=true 可以延迟加载工具，减少开销。

6.3 OpenCode 配置 MCP

OpenCode 采用声明式配置，在 opencode.jsonc 中定义：

json 复制代码 
{
  "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

markdown 复制代码 
请对当前分支的所有改动做一次完整的 Code Review，重点关注：
1. 潜在的安全漏洞
2. 性能问题
3. 代码规范
输出格式用表格，包含文件名、问题描述、严重程度。

之后在 Claude Code 里输入 /review-pr 即可调用。

参数传递 ：使用 $ARGUMENTS 捕获所有参数，$1、$2 实现位置参数：

markdown 复制代码 
# .claude/commands/fix-issue.md
请修复 Issue #$1，相关文件是 $2。

输入 /fix-issue 101 src/auth.ts 即可。

7.2 OpenCode 自定义命令

在 .opencode/commands/ 目录下创建 Markdown 文件。

示例 ：.opencode/commands/test.md

markdown 复制代码 
---
description: Run tests related to the current change
agent: build
---

运行这次 session 里涉及文件的相关测试。
先总结失败，再给出最小可行的修复方案。

之后输入 /test 即可使用。

八、高级玩法：OpenCode Skills

Skills 是 OpenCode 的高级功能，比自定义命令更强大------它允许 Agent 自动发现并调用预定义的工作流。

8.1 Skill 与自定义命令的区别

特性 自定义命令 Skill
触发方式 用户显式输入 /命令名 Agent 自动发现并调用
适用场景 快速、高频的简单指令 多步骤、复杂的工作流
文件格式 单个 Markdown 目录 + SKILL.md

8.2 创建 Skill

在 .opencode/skill/<skill-name>/SKILL.md 创建文件：

markdown 复制代码 
---
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 中配置权限：

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 总耗时对比

任务 Claude Code OpenCode
跨文件重命名 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 核心差异速览

维度 Claude Code OpenCode
开源模式 闭源商业产品 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 的完整使用方法。

核心要点回顾：

  1. ✅ 掌握斜杠命令是高效使用的基础
  2. ✅ 快捷键能大幅提升操作效率
  3. ✅ 复杂任务先用 Plan 模式规划，再切 Build 执行
  4. ✅ MCP 让 AI 连接外部工具，但要注意上下文成本
  5. ✅ 自定义命令和 Skills 让重复工作自动化

工具本身不产生价值，会用工具的人才产生价值。

相关推荐
zbdx不知名菜鸡2 小时前
SwanLab 在监控什么？
人工智能·算法·机器学习
roman_日积跬步-终至千里2 小时前
Harness Engineering（驾驭工程）初识
ai
十铭忘2 小时前
OpenClaw的安装与使用 1
人工智能
Highcharts.js2 小时前
Highcharts for Python｜用 Pythonic 的方式构建AI数据可视化图表
前端·人工智能·python·信息可视化·数据科学·highcharts·ai可视化
hans汉斯2 小时前
基于污点分析的PHP应用威胁检测平台
开发语言·人工智能·算法·yolo·目标检测·php·无人机
自在极意功。2 小时前
图像识别原理
图像处理·人工智能·计算机视觉
AI精钢2 小时前
在生产环境进行 vibe coding 的正确方式
大数据·人工智能·ai·agent·claude·devops·cursor
志栋智能2 小时前
预算有限？超自动化安全运维的普惠解决方案
运维·网络·人工智能·安全·自动化
卡尔特斯2 小时前
uv 精简使用教程
python·ai编程
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03围棋-html版本04班级宠物园部署指南05小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）06UV安装并设置国内源07OpenClaw 使用和管理 MCP 完全指南08“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）09机器学习深度学习二——GAN网络10OpenClaw Control UI安全上下文访问配置