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

Java_ESS

260人浏览 · 2026-03-25 20:52:58

Java_ESS · 2026-03-25 20:52:58 发布

从入门到精通，手把手教你玩转两大终端 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 键可以在两种模式间切换。这个设计让开发者可以：

先用 Plan 模式确认 AI 理解正确
审查方案无误后，再切 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 多行输入技巧

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

行尾打 \ 再按 Enter
Option+Enter（macOS）
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 服务器：

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 与自定义命令的区别

特性	自定义命令	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 总耗时对比

任务	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 原生支持