OpenCode 是一个位于终端中的开放编程代理。它可以读取项目文件、编辑代码、运行命令和测试、搜索存储库并使用 git – 与 Claude Code 和其他控制台代理所做的事情大致相同。主要区别在于 OpenCode 不依赖于一个模型提供者：可以通过它连接数十个提供者，包括 DeepSeek。在这篇文章中，我将描述安装代理并将 DeepSeek 连接到它。
你需要什么
你只需要做两件事就可以工作：
- 现代终端。 WezTerm、Alacritty、Ghostty、Kitty 或任何其他终端都可以。
- 提供商的 API 密钥。在我们的示例中为 DeepSeek。
如果您使用标准安装脚本安装代理，则不需要 Node.js – 二进制文件已准备好。
安装
最简单的方法是官方安装脚本：
curl -fsSL https://opencode.ai/install | bash
它将检测平台本身并将可执行文件放入 PATH 中。安装后，您应该检查一切是否就位：
opencode --version
如果命令显示版本，则安装成功。
使用其他方法安装
如果您更喜欢包管理器，有多种选择。通过 Node.js：
npm install -g opencode-ai
Bun、pnpm 和 Yarn 也可以做同样的事情：
bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai
macOS 和 Linux 有 Homebrew。请注意：这是开发人员推荐的公式，而不是官方公式 – 它更新频率较低：
brew install anomalyco/tap/opencode
在 Arch Linux 上：
sudo pacman -S opencode
paru -S opencode-bin
第一个命令从存储库安装稳定版本，第二个命令从 AUR 安装最新版本。
在 Windows 上安装
在 Windows 中，建议通过 WSL 工作：这样性能更高，并且与代理功能的兼容性更完整。但也有本地方法。通过 Chocolatey、Scoop 或 npm：
choco install opencode
scoop install opencode
npm install -g opencode-ai
还有一个通过 Mise 以及 Docker 容器的选项：
mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode
最后，完成的二进制文件始终可以从 GitHub 上的发布页面获取。
DeepSeek 键
密钥在您的 DeepSeek 个人帐户中创建。转到 platform.deepseek.com，打开包含 API 密钥的部分，然后单击“创建新密钥”。最好立即保存结果字符串：它只会显示一次。
DeepSeek 连接
然后一切都在代理本身内部完成。在终端中启动 OpenCode：
opencode
在界面中我们执行连接命令：
/connect
在打开的提供商列表中，查找 DeepSeek，选择它并插入 API 密钥。以这种方式添加的密钥将保存到文件中：
~/.local/share/opencode/auth.json
连接后，剩下的就是使用以下命令选择模型：
/models
DeepSeek 型号将出现在列表中，包括 deepseek-v4-pro、deepseek-flash 和 deepseek-v4-flash。对于存储库中的日常工作，闪存选项就足够了；对于复杂的任务，切换到专业版是有意义的。
通过config进行配置
如果您不想通过 master 存储密钥或需要设置自己的 API 地址，则直接在 opencode.json 配置文件中描述提供程序：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"deepseek": {
"options": {
"baseURL": "https://api.deepseek.com"
}
}
}
}
如果您通过代理或您自己的网关，则 baseURL 字段非常有用。在这种情况下，将密钥本身传输到环境变量会很方便：
export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode
此选项适用于 CI 和一次性启动：密钥最终不会存储在存储中，而是仅存在于流程环境中。
项目中首次启动
转到项目目录并启动代理：
cd ваш_проект
opencode
第一步是初始化它：
/init
OpenCode 将分析项目结构并创建一个文件 AGENTS.md – 代理指令的模拟。该文件值得提交到 git：它可以帮助代理理解项目中采用的约定和模式。
如何使用
这项工作的结构与其他代理的结构大致相同。您应该立即了解的一些技巧：
- 规划模式。Tab 键可在规划模式和装配模式之间切换代理。第一个，他只是建议如何解决问题，并没有改变任何东西 – 在做出改变之前检查想法很方便。
- 文件链接。@ 键可打开项目文件的模糊搜索，以将特定文件传输到上下文中的代理。
- 回滚更改。/undo命令撤消最后的编辑并返回原始请求，/redo将它们返回。您可以连续回滚多个步骤。
- 共享对话。/share 命令创建当前对话的链接并将其复制到剪贴板。默认情况下，对话不会在任何地方发布。
对于简单的更改，您不必切换到计划模式，而是立即描述需要做什么并通过@指定文件。
需要注意什么
几个实际要点。 OpenCode 不需要订阅：您在花费代币时直接向提供商付款，因此 DeepSeek 的长时间会话可以预见比顶级模型便宜。密钥本地存储在 auth.json 中 – 这在共享计算机上值得考虑，但对于其他人的环境，环境变量更可靠。
还有一件事：不同类别的模型之间复杂架构问题的答案质量有所不同，因此对于设计而言，采用更强大的模型是有意义的，而将例程交给快速且廉价的模型。
链接
https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com
来源
https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/
Leave a Reply