# OpenCode 使用指南

开源编程 Agent，提供终端界面并支持配置不同模型服务商。

Canonical URL: https://aiidelist.com/zh/blog/traeide-opencode-zh

Language: zh

Published: 2026-10-03

Updated: 2026-10-03

> 本文基于 2026 年 9 月的资料整理。价格、模型和界面名称可能变化；这是一份操作指南，并非实时产品状态。

开源编程 Agent，提供终端界面并支持配置不同模型服务商。

编程 Agent · Anomaly · macOS · Windows · Linux

 

## 适合的工作流

适合希望自主选择模型服务商、继续使用现有编辑器的开发者。

## 限制与计费

服务商凭据、订阅资格与 API 费用各不相同；登录方式不能随意互换。

## 已核实的功能

Agent 工作流 · 命令行界面 · MCP · 技能 · 规则／指令 · 自带 API 密钥

这里只列出有依据的功能，并非完整功能清单。未列出的能力尚未在这条资料中核实。

## 价格与用量

**查看官方价格**

CLI 免费；模型服务商或可选服务另行收费。按量使用或外部 Agent 的费用可能与订阅分开计算。

## 模型与访问权限

连接受支持的服务商后选择模型；自定义端点需要单独配置。

已核实的模型系列： Claude, GPT, Gemini, Grok.

<span id="cli-setup"></span>

## 安装并启动 CLI

需要现代终端和受支持的服务商账户；npm 是可选安装方式之一。

```
npm install -g opencode-ai
```

在终端打开项目目录，然后运行：

```
opencode
```

## 账户与身份验证

运行 /connect 添加服务商凭据，再通过 /models 选择模型。

## 项目配置与工具

项目配置存放在 opencode.json 或 opencode.jsonc；使用 /init 创建项目指令。

## 建议尝试的首个任务

先在 Plan 模式下了解代码库，再批准一项小范围开发任务。

## 相关 CLI 工具

[查看全部 AI CLI →](/zh/blog/traeide-coding-agents-zh)

[Kilo Code CLI](/zh/blog/traeide-kilo-cli-zh) — 支持自选服务商、任务模式、MCP 与技能的终端编程 Agent。

[Aider](/zh/blog/traeide-aider-zh) — 终端结对编程工具，结合代码库映射、文件上下文与 Git 集成。

[Pi](/zh/blog/traeide-pi-zh) — 精简的终端编程 Agent，支持模型服务商、会话与扩展包配置。

## 项目评估步骤

1. 打开一个熟悉的小型项目，确认必要的语言工具能够正常工作。
2. 给 Agent 一项范围明确的修改任务，并设定可观察的验收标准。
3. 审查差异、运行项目检查，并与现有工作流的结果比较。
4. 任务结束后查看用量，据此估算同类工作一个月的费用，包括单独的模型或 Agent 账单。

## TRAE 站内延伸阅读

- [TRAE 产品详情与教程入口](/zh/ide/trae)
- [Trae IDE / TraeCode 下载指南](/zh/blog/traeide-download-zh)
- [TraeCode 使用指南](/zh/blog/traeide-traecode-zh)
- [TraeWork 使用指南](/zh/blog/traeide-traework-zh)
- [TRAE 价格：TraeCode 与 TraeWork](/zh/blog/traeide-pricing-zh)
- [TRAE 模型与访问权限](/zh/blog/traeide-models-zh)
- [TraeWork 与 TraeCode（Trae IDE）比较](/zh/blog/traeide-traework-vs-traecode-zh)
- [TRAE MCP 配置与故障排查](/zh/blog/traeide-mcp-zh)