OpenCode 中文社区

Appearance

2.5 环境管理 ​

💡 一句话总结：用 opencode models 查看可用模型，opencode stats 查看使用统计，opencode auth 管理账号。

学完你能做什么 ​

  • 查看可用模型列表
  • 统计 Token 消耗和账单
  • 管理身份凭证（登录/登出）
  • 当配置不生效时刷新缓存

1. 查看可用模型 ​

终端命令：opencode models ​

在终端直接运行：

bash
opencode models

你会看到类似这样的列表：

opencode/glm-4.7-free
anthropic/claude-3-5-sonnet-20241022
google/gemini-2.0-flash
ollama/deepseek-r1:7b
zhipuai-coding-plan/glm-4.7

进阶技巧：只看特定厂商 ​

bash
# 只看 Anthropic 的模型
opencode models anthropic

# 只看 DeepSeek 的模型
opencode models deepseek

进阶技巧：查看价格 ​

bash
opencode models --verbose

输出会包含详细的元数据，包括 inputCost（输入价格）和 outputCost（输出价格）。

进阶技巧：刷新缓存 ​

如果你刚配置了新 Key，需要强制刷新：

bash
opencode models --refresh

把心仪的模型设为默认 ​

打开配置文件 ~/.config/opencode/opencode.json：

json
{
  "model": "zhipuai-coding-plan/glm-4.7"
}

2. 查看使用统计 ​

终端命令：opencode stats ​

运行：

bash
opencode stats

你会看到一个详细的仪表盘：

┌────────────────────────────────────────────────────────┐
│                       OVERVIEW                         │
├────────────────────────────────────────────────────────┤
│Sessions                                           948 │
│Messages                                        30,575 │
│Days                                                29 │
└────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────┐
│                    COST & TOKENS                       │
├────────────────────────────────────────────────────────┤
│Total Cost                                    $1232.56 │
│Avg Cost/Day                                    $42.50 │
│Input                                           530.6M │
│Output                                            9.9M │
│Cache Read                                      703.0M │
└────────────────────────────────────────────────────────┘

关键指标解读 ​

  • Total Cost：估算的美元费用
  • Input：你发给 AI 的内容 + AI 读取的文件内容
  • Output：AI 写的代码和回复
  • Cache Read：🔥 核心省钱指标！这是 OpenCode 帮你省下的钱

进阶：项目独立统计（需 Git） ​

bash
# 只看当前项目的统计
opencode stats --project ""

看看谁是"吃 Token 大户" ​

bash
# 显示消耗最高的 5 个模型
opencode stats --models 5

只看最近几天的消耗 ​

bash
# 只看过去 24 小时的统计
opencode stats --days 1

# 查看最近 7 天
opencode stats --days 7

3. 管理身份凭证 ​

查看凭证列表 ​

bash
opencode auth list

你会看到类似这样的树状图：

Credentials ~/.local/share/opencode/auth.json
┌
●  Zhipu AI Coding Plan  api
│
●  Google  oauth
│
●  OpenAI  oauth
│
└  3 credentials

认证方式：

  • api：通过输入 sk-... 密钥添加的
  • oauth：通过网页跳转登录授权的

登出/删除凭证 ​

bash
opencode auth logout

然后按 ↑ ↓ 选择要删除的提供商，回车确认。

⚠️ 安全提示：凭证存储在 ~/.local/share/opencode/auth.json，以明文 JSON 格式存储。

4. TUI 里的对应操作 ​

你想做什么终端命令TUI 斜杠命令
切换模型opencode -m <id>/model 或 /models
登录账号opencode auth login/connect
查看统计opencode stats/stats (仅显示简报)
退出程序Ctrl+C/exit

检查点 ​

✅ 全部通过才能继续：

  • [ ] 运行 opencode models，确认看到了你配置的模型
  • [ ] 运行 opencode stats，看了一眼自己的 Token 消耗
  • [ ] 运行 opencode auth list，清理掉不需要的旧凭证

下一课预告 ​

下一课我们进入 第三阶段：高效工作流。

你会学到：

  • 什么是 Plan（思考）模式
  • 什么是 Build（执行）模式
  • 如何在这两种模式间切换，让 AI 更聪明地工作
微信群