前言
OpenCode是一款开源的AI编程助手，专为开发者设计，深度集成终端环境，支持多种AI模型，可帮你高效完成代码编写、调试、重构等任务。无论你是Vim爱好者还是Neovim用户，OpenCode都能无缝融入你的工作流。本教程将带你快速入门OpenCode，从安装到实战，轻松上手！

一、安装OpenCode
OpenCode支持多种安装方式，推荐使用npm或包管理器安装，简单高效。

1. 使用npm安装（推荐）

• 打开终端（Windows 使用 PowerShell/CMD，macOS/Linux 使用 Terminal）。
• 执行命令安装OpenCode：

npm install -g opencode-ai

• 验证安装是否成功：

opencode --version

• 若显示版本号，则安装成功。

2. 其他安装方式

• Windows用户：可使用Chocolatey或Scoop包管理器：

# Chocolatey安装
choco install opencode
# Scoop安装
scoop install opencode

• macOS用户：使用Homebrew安装：

brew install anomalyco/tap/opencode

• Docker用户（快速测试，不影响本地环境）：

docker run -it --rm ghcr.io/anomalyco/opencode

• 注意：Docker方式每次重启后配置会重置，需重新配置。

二、配置API密钥
安装完成后，需配置API密钥才能使用OpenCode的AI能力。

1. 启动OpenCode
在终端输入 opencode 并回车，进入交互界面（TUI）。

2. 配置API密钥

• 在TUI界面输入命令 /connect 并回车。
• 选择AI模型提供商，推荐新手使用 OpenCode Zen（免费模型）。
• 按提示访问 opencode.ai/auth 登录，登录并获取 API 密钥。
• 将密钥粘贴到终端并确认。

三、基础使用与核心功能
配置完成后，即可开始使用OpenCode的核心功能。

1. 进入项目目录
使用 cd 命令进入你的代码项目文件夹。

2. 两种工作模式
OpenCode提供两种模式，可通过 Tab 键切换：

• Plan模式（默认）：AI 分析需求并提供建议（不修改文件），适合验证方案。
• Build模式：AI直接修改代码文件，高效实现需求。

3. 与AI交互
在输入框描述需求，例如：

“帮我写一个登录页面的HTML和CSS代码”

AI将自动生成代码，并支持进一步迭代优化。

4. 切换AI模型
按 Ctrl + P 可切换不同模型（如OpenAI、Claude、DeepSeek等），选择最适合当前任务的模型。

四、实用技巧与进阶操作

1. Shell命令集成：在OpenCode中输入 !命令（如 !ls）可直接执行Shell命令，结果会自动融入对话上下文。
2. 文件引用：使用 @文件名 指定操作文件，例如：

重构 @src/utils/api.ts 中的 request 函数，使用 async/await 替代 Promise.then

3. 会话管理：
   • /undo：撤销上一次修改（依赖Git）。
   • /redo：重做撤销的操作。
   • /new：新建会话。
4. 图片支持：拖拽设计稿或截图到终端，AI可解析并生成对应代码（如Vue组件）。

五、实战案例：生成2048小游戏

1. 在项目目录启动OpenCode。
2. 输入需求：

帮我生成一个2048小游戏的HTML代码

3. AI将生成代码并保存在项目文件夹中，可直接运行测试。

六、常见问题与建议

1. Docker配置重置：每次重启需重新配置API密钥。
2. 模型选择：免费模型（如OpenCode Zen）适合轻量任务，复杂需求可切换付费模型。
3. 提示词优化：明确需求（如指定文件、技术栈），例如：

优化 @app.js 中的渲染函数，使用React Hooks重构

结语
OpenCode作为终端原生的AI编程助手，极大提升了开发效率。通过灵活的模式切换、多模型支持和智能上下文分析，它能成为你编码过程中的得力伙伴。未来还可探索其桌面应用或VS Code集成，解锁更多可能！

参考资料：

• OpenCode官网：opencode.ai
• GitHub仓库：github.com/anomalyco/opencode

欢迎留言交流你的OpenCode使用心得~ 🌟