什么是 OpenCode?
OpenCode 是一个开源的 AI 编程助手（Coding Agent），专为终端环境设计。 它不同于传统的图形界面工具，而是通过终端交互界面（TUI）直接"住"在你的终端里，让 AI 编程变得前所未有的高效。
为什么选择 OpenCode?
- ✓ 完全开源，本地运行，保护代码隐私
- ✓ 支持多种 AI 模型（Claude、GPT-4、Gemini）
- ✓ 强大的文件操作和代码编辑能力
- ✓ 支持 Python、JavaScript、TypeScript 等多种语言
⚠️ 安装前准备
系统要求
- Windows 10/11 (64位)
- 至少 4GB 内存
- 至少 2GB 磁盘空间
需要准备
- API Key (Claude/GPT)
- 管理员权限
- 稳定的网络连接
安装 Node.js
OpenCode 基于 Node.js 构建，这是第一步
⬇️ 方法一：官网下载安装（推荐）
访问 Node.js 官方网站下载页面
前往 nodejs.org点击下载 Windows 安装包（LTS 版本）
下载 node-v20.x.x-x64.msi
双击运行安装程序，按向导完成安装
提示： 安装过程中保持默认选项即可，会自动添加到系统 PATH
⚡ 方法二：使用 NVM 安装（高级用户）
NVM (Node Version Manager) 可以让你轻松管理多个 Node.js 版本
# 1. 以管理员身份打开 PowerShell，安装 NVM-Windows
winget install CoreyButler.NVMforWindows
# 2. 重启终端，安装 Node.js
nvm install 20
nvm use 20
# 3. 验证安装
node --version
npm --version验证 Node.js 安装
打开命令提示符（CMD）或 PowerShell，运行以下命令：
安装成功！
如果看到版本号，说明 Node.js 安装正确
❌ 遇到问题？
- • 如果提示 "node 不是内部或外部命令"，请重启终端或电脑
- • 检查环境变量是否配置正确：此电脑 → 属性 → 高级系统设置 → 环境变量
- • 确保 Node.js 安装路径已添加到 PATH
安装 OpenCode
使用 npm 全局安装 OpenCode
全局安装 OpenCode
打开终端（PowerShell 或 CMD），运行以下命令：
# 全局安装 OpenCode
npm install -g @opencode/opencode
# 或者使用 yarn
yarn global add @opencode/opencode
# 或者使用 pnpm
pnpm add -g @opencode/opencode🔧 配置 API Key
OpenCode 需要 AI 模型的 API Key 才能工作。支持 Claude、OpenAI、Gemini 等。
🤖 获取 Claude API Key
- 访问 Anthropic Console
- 注册或登录账号
- 进入 "API Keys" 页面
- 点击 "Create Key" 创建新密钥
- 复制生成的 API Key（以 sk-ant 开头）
🤖 获取 OpenAI API Key
- 访问 OpenAI Platform
- 登录你的 OpenAI 账号
- 点击 "Create new secret key"
- 复制生成的 API Key（以 sk- 开头）
配置 OpenCode
首次运行 OpenCode 时会自动创建配置文件。你也可以手动配置：
# 启动 OpenCode 配置向导
opencode config
# 或者直接在配置文件中设置
code %USERPROFILE%\.opencode\config.json配置文件示例 (config.json):
{
"model": "claude-3-5-sonnet-20241022",
"anthropicKey": "sk-ant-api03-your-api-key-here",
"openaiKey": "sk-your-openai-key-here",
"language": "zh-CN",
"autoApprove": false,
"editDelay": 1000,
"maxIterations": 10
}⚙️ 配置项说明
model- 使用的 AI 模型anthropicKey- Claude API KeyopenaiKey- OpenAI API Keylanguage- 界面语言
🔒 安全提示
- • 永远不要分享你的 API Key
- • 不要将 API Key 提交到 Git
- • 定期轮换你的 API Key
- • 使用环境变量存储敏感信息
使用 OpenCode 安装 Python 环境
让 AI 帮你自动化安装和配置 Python
🚀 启动 OpenCode
在终端中输入以下命令启动 OpenCode：
# 在当前目录启动 OpenCode
opencode
# 或者指定目录
opencode /path/to/your/project
# 启动后你会看到交互式界面
?💬 让 OpenCode 安装 Python
在 OpenCode 的交互界面中，输入以下指令：
输入指令：
"帮我安装 Python 3.11 并配置虚拟环境，创建一个新的 Python 项目结构"
OpenCode 会自动执行以下操作
OpenCode 的执行过程：
# 1. 检查系统是否已安装 Python
python --version
# 2. 如果没有安装，下载并安装 Python 3.11
# - 访问 python.org
# - 下载 Windows installer
# - 运行安装程序
# 3. 创建项目目录结构
mkdir my-python-project
cd my-python-project
# 4. 创建 Python 虚拟环境
python -m venv venv
# 5. 激活虚拟环境
.\\venv\\Scripts\\activate
# 6. 创建项目文件
# - main.py
# - requirements.txt
# - .gitignore
# - README.md
# 7. 安装常用依赖包
pip install requests numpy pandas✨ 其他常用 Python 环境指令
"安装 Django 并创建一个新的 Web 项目"
OpenCode 会自动配置 Django 环境
"安装 Flask 并创建一个 REST API 项目"
包含路由配置和基本示例
"配置 Jupyter Notebook 环境"
安装数据科学常用库
"设置 Pytest 测试环境"
创建测试目录结构和示例
OpenCode 使用技巧
智能代码补全
使用 Tab 键接受 AI 建议的代码补全
文件操作
直接说"读取文件"、"创建文件"或"修改文件"
代码搜索
使用自然语言搜索代码，如"查找所有包含 user 的函数"
调试助手
粘贴错误信息，让 AI 帮你分析和修复
常用命令
| 命令 | 功能 |
|---|---|
| /help | 显示帮助信息 |
| /clear | 清空对话历史 |
| /config | 打开配置界面 |
| /exit | 退出 OpenCode |
常见问题
Q: 安装时出现权限错误怎么办？
以管理员身份运行 PowerShell，或者在命令前添加 sudo（如果使用 Windows Terminal）。
Q: 如何更新 OpenCode？
运行 npm update -g @opencode/opencode 即可更新到最新版本。
Q: API Key 保存在哪里？安全吗？
API Key 保存在本地的配置文件中（%USERPROFILE%\.opencode\config.json）。请确保不要将配置文件提交到 Git 仓库。
Q: OpenCode 支持哪些 AI 模型？
支持 Claude 3.5 Sonnet、Claude 3 Opus、GPT-4、GPT-4 Turbo、Gemini Pro 等主流模型。
Q: 如何卸载 OpenCode？
运行 npm uninstall -g @opencode/opencode 即可卸载。