Skip to content

OpenCode

OpenCode 是一款开源的 AI 编程工具,运行在终端中,支持通过 PeterPark API 调用 Claude、GPT 等模型辅助编程。

什么是 OpenCode?

OpenCode 类似于 Claude Code,是一个在终端中运行的 AI 编程助手。它完全开源,支持自定义配置,可以接入任何兼容 OpenAI 格式的 API。

安装 OpenCode

确保已安装 Node.js 18+,然后运行:

bash
npm install -g opencode-ai

验证安装:

bash
opencode --version

配置 PeterPark API

方法一:环境变量(推荐)

bash
export OPENAI_API_KEY="sk-pp-your-key-here"
export OPENAI_BASE_URL="https://api.peterpark.cn/v1"

永久配置(添加到 ~/.bashrc~/.zshrc):

bash
echo 'export OPENAI_API_KEY="sk-pp-your-key-here"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.peterpark.cn/v1"' >> ~/.zshrc
source ~/.zshrc

方法二:配置文件

创建或编辑 ~/.opencode/config.json

json
{
  "provider": "openai",
  "model": "claude-sonnet-4-5",
  "apiKey": "sk-pp-your-key-here",
  "baseUrl": "https://api.peterpark.cn/v1"
}

基本使用

启动 OpenCode

bash
# 在当前项目目录启动
cd your-project
opencode

常用命令

在 OpenCode 交互界面中:

命令说明
直接输入问题向 AI 提问
/add <文件路径>将文件加入上下文
/clear清除当前对话上下文
/model <模型ID>切换模型
/exit退出 OpenCode

示例工作流

bash
# 进入项目目录
cd my-project

# 启动 OpenCode
opencode

# 在交互界面中
> /add src/app.js
> 这个文件有什么问题?帮我优化一下

指定模型

bash
# 启动时指定模型
opencode --model gpt-4o

# 或在配置文件中设置默认模型

与 CC-Switch 配合使用

如果你同时使用多个 AI 工具,可以配合 CC-Switch 快速切换 API 配置:

bash
# 切换到 PeterPark
cc-switch use peterpark

# 启动 OpenCode(自动使用当前配置)
opencode

PeterPark API 文档