OpenCode

OpenCode | 简介  
OpenCode | 规则  
OpenCode 入门教程  
OpenCode skills 使用  
安装 Node.js  

Windows全局的Agents配置文件在【C:\Users\XXX\.config\opencode】
C:\Users\Administrator\.config\opencode

Windows全局的Skill路径在【C:\Users\用户名\.config\opencode\skills】
C:\Users\Administrator\.config\opencode\skills

1、安装 Node.js
https://nodejs.org/zh-cn

# 验证 Node.js 版本：

node -v

# 验证 npm 版本：

npm -v

# 验证 npx 版本：

npx --version

npx cowsay "你好，世界！"

2、安装 OpenCode
打开 PowerShell 或 CMD，以管理员身份运行，运行：
# 全局安装 OpenCode

npm install -g opencode-ai@latest
npm install -g opencode-ai@latest  --registry https://registry.npmjs.org

# 验证 OpenCode 安装

opencode --version

*、启动 OpenCode
# 进入项目目录

cd E:\test\OpenCodeProject\test1

# 启动 OpenCode

opencode

# 选择模型 
OpenCode 启动后：
输入 /model
输入 univibe 进行搜索
从列表中选择你配置的模型（例如 claude-sonnet-4-5 或 gpt-5.2）
回车确认

*、配置 API 密钥与模型
连接一个 AI 提供商的 API 密钥，例如 OpenAI 或 Anthropic Claude，运行：

/conncetion

*、OpenCode 项目初始化

/init

会生成一个 .opencode/ 文件夹，用于存储项目的向量化索引和自定义指令。
它会扫描当前目录的代码结构，并生成一个用于记录项目信息的 AGENTS.md 文件。

*、常用命令

/init — 初始化项目 这个命令很重要！它会在项目根目录创建一个 AGENTS.md 文件，里面会自动分析你的项目结构、读取关键配置和文档。OpenCode 会默认读取这个文件作为全局提示词
/connect — 连接模型提供商，想换模型的时候用这个命令，可选择粘贴第三方模型 API Key 连接外部模型（如 Claude、GPT-4），或直接使用内置的免费开源模型（如 GLM-4.7）。
/model — 切换模型，选择模型，快速切换当前使用的模型
/session — 查看会话列表 可以看到之前所有的对话记录，选择继续或者删除。
/new — 新对话
/compact — 压缩会话，当对话内容太多，快超出模型上下文限制的时候，用这个命令压缩一下。
/help — 查看帮助
/exit — 退出 OpenCode

*、文件操作

/open - 搜索并打开文件，输入文件名（支持模糊搜索），就能快速打开文件预览。
/review - 审查代码，默认会审查未提交的代码变更，也可以指定文件。

*、功能开关

/mcp - 开启或关闭 MCP MCP 是 Model Context Protocol，可以让 OpenCode 调用外部工具。
/agent - 选择 Agent OpenCode 支持多种 Agent，用这个命令切换。

*、其他实用命令

/terminal - 显示或隐藏终端 可以在 OpenCode 里直接运行 shell 命令。
/undo - 撤销上一步操作

*、Plan/Build 双模式：安全又高效
OpenCode 有个很棒的设计，就是 Plan 和 Build 两种模式。按 Tab 键就能在 Plan 和 Build 模式之间切换。
● Plan 模式：只看不干，只读规划，默认拒绝编辑，需要确认
在这个模式下，AI 只能分析你的项目、规划任务，但不能修改任何文件
这就像你在跟一个技术顾问聊天，让他帮你分析问题、制定方案，但他不会直接动手改代码
● Build 模式：说干就干，全权限，可直接编辑文件、执行命令
Build 模式下，AI 就有完整权限了，可以读写文件、运行命令、修改代码。

*、OpenCode 服务（Docker 方式）

docker run -d \
  --name opencode-server \
  -p 3000:3000 \
  -v $(pwd)/opencode-config:/root/.opencode \
  -e OPENCODE_MODEL_PROVIDER="myprovider" \
  -e OPENCODE_MODEL_NAME="Qwen3-4B-Instruct-2507" \
  opencode-ai/opencode:latest

说明：该命令默认监听 http://localhost:3000，这是 VS Code 插件后续要连接的地址。-v 参数挂载了配置目录，方便你后续修改 opencode.json。

# 进入容器并启动 OpenCode
# 打开新终端窗口，连接正在运行的容器：

docker exec -it opencode-server bash

# 进入容器后，直接输入命令启动 OpenCode：

opencode

此时将进入图形化终端界面（TUI），可通过 Tab 键在不同 Agent 模式间切换，开始享受 AI 辅助编码。

*、Opencode设置思考和回答语言为中文
在项目或者全局的AGENTS.md文件中添加语言要求：

## 交互要求

- Thinking思考过程用中文表述
- Reply回答也要用中文回复


## 交互要求
1. 你在处理所有问题时，**全程思考过程必须使用中文**（包括需求分析、逻辑拆解、方案选择、步骤推导等所有内部推理环节）；
2. 最终输出的所有回答内容（包括文字解释、代码注释、步骤说明等）**必须全部使用中文**，仅代码语法本身的英文关键词除外。

*
*
*
*
*
*