终端 AI 编程实战指南：Claude Code 与 OpenCode 双工具上手

📚 分类: AI 编程工具 ⏱️ 预计耗时: 60 分钟 🎯 难度: 入门 / 中级 🔧 环境要求: macOS / Linux / Windows (WSL2), Node.js ≥ 18.0, Git

你将学到什么

完成本教程后，你将能够：

[ ] 在终端中启动并使用 Claude Code 和 OpenCode 两大 AI 编程助手
[ ] 掌握两个工具的核心命令、快捷键和工作模式
[ ] 通过 MCP 服务器让 AI 连接外部工具（如 GitHub）
[ ] 创建自定义命令和 Skills，实现自动化工作流
[ ] 根据项目需求，做出合理的工具选型判断

最终效果

你将能在自己的项目目录中，熟练使用 Claude Code 或 OpenCode 完成代码分析、重构、编写测试等任务，并能够配置高级功能来提升效率。

前置准备

在开始前，请确认你的环境满足以下条件：

检查项	要求版本	验证命令
Node.js	≥ 18.0	`node -v`
npm	≥ 9.0	`npm -v`
Git	≥ 2.30	`git --version`

1. 安装 Claude Code

bash

$ npm install -g @anthropic-ai/claude-code    // 全局安装 Claude Code
$ claude --version                            // 验证安装：应输出版本号

✅ 验证：如果终端输出版本号（例如 0.1.0），说明安装成功。

2. 安装 OpenCode

bash

$ npm install -g @opencode-ai/cli             // 全局安装 OpenCode
$ opencode --version                          // 验证安装：应输出版本号

✅ 验证：如果终端输出版本号（例如 0.2.0），说明安装成功。

⚠️ 注意：如果遇到权限错误，在命令前加 sudo（Mac/Linux）或以管理员身份运行终端（Windows）。

第 1 步：5 分钟快速上手

🎯 目标：启动工具，完成第一次对话，验证环境配置无误。

1.1 启动 Claude Code

bash

# 进入你的项目目录（没有项目就创建一个空目录）
$ cd your-project

# 启动 Claude Code
$ claude

首次启动会提示登录（需要 Claude Pro/Max 订阅）。登录成功后，你会看到一个交互式终端界面。

📝 操作：在 Claude Code 的交互界面中，输入以下指令并回车：

分析一下这个项目的技术栈

✅ 验证：Claude Code 会扫描项目文件并返回一个技术栈报告（例如：这是一个 Node.js 项目，使用了 Express 框架...）。能正常返回结果，说明配置成功。

1.2 启动 OpenCode

bash

# 进入你的项目目录
$ cd your-project

# 启动 OpenCode
$ opencode

📝 操作：首次启动需要配置模型提供商。

在 OpenCode 界面中输入 /connect 并回车。
根据提示选择你的模型提供商（例如 OpenAI、Anthropic 或 Ollama）。
输入你的 API Key。
配置完成后，输入以下指令：

@src 分析一下这个项目的技术栈

✅ 验证：OpenCode 会扫描项目文件并返回技术栈报告。能正常返回结果，说明配置成功。

💡 提示：新手最大的误区是直接让 AI 改代码。先用“分析”指令探索项目，再执行修改任务。

第 2 步：掌握核心命令体系

🎯 目标：学会使用两个工具中最常用的斜杠命令，告别低效的“聊天式”编程。

2.1 Claude Code 核心命令

在 Claude Code 的交互界面中，输入 /help 可以查看所有命令。这里列出最常用的几个：

命令	作用	何时使用
`/init`	生成 `CLAUDE.md` 项目记忆文件	新项目第一次使用，让 AI 记住你的项目规范
`/compact`	压缩对话历史，释放上下文空间	会话超过 30 分钟，或出现上下文警告时
`/clear`	清空所有对话历史	切换到完全不同的任务时
`/model`	切换模型（如 `sonnet`, `opus`）	简单任务用小模型省 token，复杂任务用大模型
`/cost`	显示当前会话的 Token 消耗和费用	每次结束前看看花了多少钱
`/plan`	进入计划模式（只读，不修改代码）	复杂任务先规划再执行
`/help`	显示所有可用命令	忘记命令时随手查

📝 操作：在 Claude Code 界面中，尝试输入以下命令：

/init

✅ 验证：Claude Code 会询问你项目的技术栈、编码规范等信息，并生成一个 CLAUDE.md 文件。

🤔 为什么要这样做？ CLAUDE.md 是项目的“记忆”文件。它告诉 AI 你的项目是做什么的、用了什么技术、有什么编码规范。这样 AI 后续生成的代码会更符合你的预期，而不会每次都从零开始“猜测”。

2.2 OpenCode 核心命令

在 OpenCode 的交互界面中，输入 /help 可以查看所有命令。它最核心的理念是 Plan 与 Build 分离。

命令	作用	何时使用
`/init`	生成 `AGENTS.md` 项目记忆文件	新项目第一次使用
`/connect`	配置 AI 模型提供商	首次使用或更换模型时
`/plan`	切换到 Plan 模式（只分析不修改）	代码审查、性能分析
`/build`	切换到 Build 模式（实际修改代码）	重构、添加功能
`/undo`	撤销最近一次修改	AI 改错了回滚
`/redo`	重做撤销的操作	恢复误撤销
`/help`	显示所有可用命令	忘记命令时随手查

📝 操作：在 OpenCode 界面中，先输入 /plan 进入计划模式，然后输入以下指令：

请解释 @src/auth/index.ts 里的认证流程。先不要修改任何内容。

✅ 验证：AI 会分析文件并解释其逻辑，但不会修改任何代码。

📝 操作：确认理解后，输入 /build 切换到构建模式，然后输入：

现在按照刚才的方案，为 @src/auth/index.ts 添加一个简单的日志功能。

✅ 验证：AI 会修改代码。你可以用 git diff 命令查看改动了哪些内容。

⚠️ 注意：OpenCode 的 @ 符号可以模糊搜索并引用文件，无需手动复制粘贴文件内容。

第 3 步：掌握快捷键，告别纯打字

🎯 目标：学会使用快捷键，将操作效率提升 2 倍以上。

3.1 Claude Code 快捷键

快捷键	功能	说明
`Ctrl + C`	取消当前输入/生成	AI 跑偏了赶紧刹车
`Ctrl + D`	退出会话	安全退出
`Ctrl + L`	清屏	保持终端界面整洁
`Ctrl + R`	反向搜索命令历史	快速定位历史输入
`Esc + Esc`	撤销最近一次文件改动	救命键，改坏了一键回退
`Shift + Enter`	多行输入换行	不发送，继续输入下一行

3.2 OpenCode 快捷键

快捷键	功能	说明
`Tab`	切换 Plan / Build 模式	核心快捷键，快速切换工作状态

3.3 多行输入技巧

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

行尾加反斜杠：在行尾输入 \ 再按 Enter，可以继续输入下一行。
Option + Enter（macOS）：直接换行。
Shift + Enter（跨平台通用）：最推荐的方法。

第 4 步：实战 Plan vs Build 工作模式

🎯 目标：理解并应用“先规划，后执行”的 AI 编程最佳实践。

4.1 复杂任务的标准流程

面对一个复杂的重构任务（例如“将项目中所有的 user_id 重命名为 userId”），不要一上来就让 AI 动手。

错误示范（直接动手）：

将项目中所有的 user_id 重命名为 userId。

正确流程（先规划，后执行）：

第一步：用 Plan 模式分析

在 Claude Code 或 OpenCode 的 Plan 模式下输入：

请分析一下这个项目的架构，找出所有包含 `user_id` 的文件，并制定一个重命名计划。先不要修改任何代码。

第二步：审查计划

AI 会返回一个计划，例如：“需要修改 src/auth.ts 的第 10 行，src/user.ts 的第 25 行...”。仔细审查这个计划，确保 AI 理解了你的意图。

第三步：用 Build 模式执行

确认计划无误后，切换到 Build 模式，输入：

现在按照刚才的计划，执行重命名操作。

🤔 为什么要这样做？ 这个流程可以避免 AI 在错误的方向上狂奔。如果 AI 理解错了，你可以在 Plan 阶段纠正它，而不是等它改完一大堆文件后再回滚。

4.2 实战对比：跨文件重命名

为了让你直观感受两个工具的差异，我们来看一个真实的测试场景。

任务：将代码库中所有 user_id 重命名为 userId（驼峰命名），确保编译通过。

Claude Code 表现（耗时 3 分 6 秒）：
- 重命名了所有代码中的变量
- 保留了 JSDoc 注释，认为注释是独立层，不应修改
OpenCode 表现（耗时 3 分 13 秒）：
- 重命名了所有代码中的变量
- 连注释里的 user_id 也改了，确保 API 文档一致性

谁更好？ 取决于你的团队规范。如果你的注释会被其他工具（如 Swagger）解析，OpenCode 更彻底；如果注释是内部笔记，Claude Code 更谨慎。

第 5 步：高级玩法：配置 MCP 服务器

🎯 目标：让 AI 连接外部工具（如 GitHub、数据库），扩展其能力边界。

5.1 什么是 MCP？

MCP（Model Context Protocol，模型上下文协议）是让 AI 调用外部工具的能力标准。简单说，它让 AI 能做的事情远超“写代码”：

连接 GitHub：查看 PR、创建 Issue
连接 PostgreSQL：直接查询数据库
连接 Sentry：获取错误日志

5.2 Claude Code 配置 MCP

通过命令行添加 MCP 服务器：

bash

$ claude mcp add github

启用/禁用服务器：

/mcp

5.3 OpenCode 配置 MCP

OpenCode 采用声明式配置，在项目根目录的 opencode.jsonc 文件中定义：

json

{
  "mcp": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

✅ 验证：配置完成后，在 AI 对话中输入类似“查看这个仓库的最新 PR”的指令，如果 AI 能正常调用 GitHub API 并返回结果，说明 MCP 配置成功。

⚠️ 注意：启用 MCP 服务器会消耗上下文窗口。每个服务器会往上下文里添加工具定义，7 个活跃服务器可能吃掉 25% 的上下文。建议只启用你真正需要的服务器。

进阶技巧（可选）

1. Claude Code 自定义命令

在项目的 .claude/commands/ 目录下创建 .md 文件，就能定义自己的命令。

示例：创建 .claude/commands/review-pr.md：

markdown

请对当前分支的所有改动做一次完整的 Code Review，重点关注：

- 安全性
- 性能
- 代码风格
- 潜在 Bug

输出格式用表格，包含文件名、问题描述、严重程度。

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

2. OpenCode 自定义命令

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

示例：创建 .opencode/commands/test.md：

markdown

---
description: Run tests related to the current change
agent: build
---

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

之后输入 /test 即可使用。

3. OpenCode Skills

Skills 比自定义命令更强大——它允许 Agent 自动发现并调用预定义的工作流。

创建 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.

常见问题 (FAQ)

Q1: 启动时提示 Error: listen EADDRINUSE 怎么办？A: 说明端口被占用。找到占用进程并结束它：

bash

$ lsof -i :3000          // 查看占用进程
$ kill -9 [PID]          // 结束进程后重试

Q2: module not found 报错怎么办？A: 说明依赖未安装。运行 npm install 后重试。如果仍然报错，删除 node_modules 文件夹和 package-lock.json，重新执行 npm install。

Q3: Claude Code 提示需要订阅怎么办？A: Claude Code 需要 Claude Pro/Max 订阅（$20-200/月）。如果预算有限，可以优先使用 OpenCode，它只需要你自备 API Key。

Q4: OpenCode 配置模型时找不到我的提供商怎么办？A: OpenCode 支持 75+ 提供商。如果列表中没有你想要的，可以尝试选择“Custom”并手动配置 API 地址和 Key。

总结

恭喜你完成了本教程！🎉

回顾一下我们今天学到的核心内容：

安装与启动：掌握了两个工具的全局安装和首次启动配置。
核心命令：学会了 /init、/plan、/build 等命令的用法，告别低效聊天。
快捷键：掌握了 Ctrl + C、Esc + Esc 等救命快捷键。
工作模式：理解了“先 Plan 后 Build”的最佳实践，避免 AI 在错误方向狂奔。
高级玩法：了解了 MCP、自定义命令和 Skills，扩展 AI 的能力边界。

选型建议

维度	Claude Code	OpenCode
开源	❌ 闭源商业产品	✅ MIT 开源
模型支持	仅 Claude	75+ 提供商 + 本地模型
速度	⚡ 更快	🛡️ 更稳健
订阅要求	Claude Pro/Max（$20-200/月）	免费工具，自备 API Key
本地模型	❌ 不支持	✅ Ollama 原生支持

选择 Claude Code 如果：

追求极致速度和流畅体验
已订阅 Claude Pro/Max
只需要 Claude 模型

选择 OpenCode 如果：

想要开源自由，可以查看/修改源码
需要自由切换模型（GPT-4、Claude、本地模型）
需要本地部署保障数据隐私
预算有限，想复用已有 API Key

终极建议：两个都装！ Claude Code 适合快速迭代、日常编码；OpenCode 适合复杂重构、多模型切换。它们可以共存，互补使用。

下一步

如果你想继续深入，建议学习：

📖 Claude Code 官方文档
📖 OpenCode 官方文档

💡 练习任务：尝试用本教程学到的知识，在你的一个项目中完成一次“先 Plan 后 Build”的代码重构。这是巩固知识的最佳方式。

yaml


## 相关文档

- [OpenCode Zen 实战教程：快速接入精选 AI 模型](/docs/chu-ci-shi-yong/opencode-zen-shi-zhan-jiao-cheng-kuai-su-jie-ru-jing-xuan-ai-mo-xing.html)
- [OpenCode 终端 AI 编程助手 实战教程](/docs/chu-ci-shi-yong/opencode-zhong-duan-ai-bian-cheng-zhu-shou-shi-zhan-jiao-cheng.html)
- [OpenCode 实战教程：在终端里玩转 AI 编程助手](/docs/chu-ci-shi-yong/opencode-shi-zhan-jiao-cheng-zai-zhong-duan-li-wan-zhuan-ai-bian-cheng-zhu-shou.html)

终端 AI 编程实战指南：Claude Code 与 OpenCode 双工具上手 ​

你将学到什么 ​

最终效果 ​

前置准备 ​

1. 安装 Claude Code ​

2. 安装 OpenCode ​

第 1 步：5 分钟快速上手 ​

1.1 启动 Claude Code ​

1.2 启动 OpenCode ​

第 2 步：掌握核心命令体系 ​

2.1 Claude Code 核心命令 ​

2.2 OpenCode 核心命令 ​

第 3 步：掌握快捷键，告别纯打字 ​

3.1 Claude Code 快捷键 ​

3.2 OpenCode 快捷键 ​

3.3 多行输入技巧 ​

第 4 步：实战 Plan vs Build 工作模式 ​

4.1 复杂任务的标准流程 ​

4.2 实战对比：跨文件重命名 ​

第 5 步：高级玩法：配置 MCP 服务器 ​

5.1 什么是 MCP？ ​

5.2 Claude Code 配置 MCP ​

5.3 OpenCode 配置 MCP ​

进阶技巧（可选） ​

1. Claude Code 自定义命令 ​

2. OpenCode 自定义命令 ​

3. OpenCode Skills ​

常见问题 (FAQ) ​

总结 ​

选型建议 ​

下一步 ​

终端 AI 编程实战指南：Claude Code 与 OpenCode 双工具上手

你将学到什么

最终效果

前置准备

1. 安装 Claude Code

2. 安装 OpenCode

第 1 步：5 分钟快速上手

1.1 启动 Claude Code

1.2 启动 OpenCode

第 2 步：掌握核心命令体系

2.1 Claude Code 核心命令

2.2 OpenCode 核心命令

第 3 步：掌握快捷键，告别纯打字

3.1 Claude Code 快捷键

3.2 OpenCode 快捷键

3.3 多行输入技巧

第 4 步：实战 Plan vs Build 工作模式

4.1 复杂任务的标准流程

4.2 实战对比：跨文件重命名

第 5 步：高级玩法：配置 MCP 服务器

5.1 什么是 MCP？

5.2 Claude Code 配置 MCP

5.3 OpenCode 配置 MCP

进阶技巧（可选）

1. Claude Code 自定义命令

2. OpenCode 自定义命令

3. OpenCode Skills

常见问题 (FAQ)

总结

选型建议

下一步