使用常见问题

使用问题解决指南

本页面汇总了 OpenCode 使用过程中常见的问题及解决方案。涵盖日常使用、技能调用、模型交互等方面。

🚀 基础使用问题

1. 命令行交互

问题：如何启动 OpenCode 交互模式？

解决方案：

bash

# 启动交互模式
opencode

# 启动交互模式并指定模型
opencode --model glm-4

# 启动交互模式并加载技能
opencode --skill git-master

问题：如何退出交互模式？

解决方案：

bash

# 在交互模式中输入
:exit
# 或
:quit
# 或按 Ctrl+C 两次

❌ 技能使用问题

1. 技能未找到

错误信息

bash

Error: Skill 'code-review' not found

解决方案

方法 1：更新技能列表

bash

opencode skill update

方法 2：安装缺失技能

bash

opencode skill install code-review

方法 3：检查技能名称

bash

# 列出所有可用技能
opencode skill list

🤖 模型交互问题

1. 模型响应质量差

问题描述

模型响应不准确、不完整或偏离主题。

解决方案

方法 1：优化提示词

bash

# 使用更具体的提示词
opencode ask "用 Python 写一个函数，计算斐波那契数列的第 n 项，使用递归实现，并添加输入验证。"

方法 2：调整模型参数

bash

# 降低温度（更确定）
opencode config set model.temperature 0.3

# 增加 Top-P（更多样）
opencode config set model.top_p 0.95

📁 文件操作问题

1. 文件读取失败

错误信息

bash

Error: Failed to read file - No such file or directory

解决方案

方法 1：检查文件路径

bash

# 确保文件存在
ls src/utils/calculator.ts

方法 2：使用绝对路径

bash

opencode skill use code-review --file /absolute/path/to/calculator.ts

🛠️ 故障排除工具

1. 健康检查

bash

# 运行健康检查
opencode doctor

# 生成诊断报告
opencode doctor --report --output health-report.html

2. 日志分析

bash

# 查看最近日志
opencode logs --tail 100

# 导出日志
opencode logs --export --output opencode-logs.txt

🎯 常见问题解答

1. 如何保存会话历史？

bash

# 启用会话历史
opencode config set history.enabled true

# 设置历史保留天数
opencode config set history.retention 30

2. 如何获取帮助？

bash

# 查看帮助
opencode --help

# 查看技能帮助
opencode skill --help

🚀 下一步

使用常见问题（补充）

常见问题补充

本页提供更多关于 OpenCode 日常使用的常见问题解答。

💰 费用与计费

1. OpenCode 是否免费使用？

是的，OpenCode 基础功能完全免费。

✅ 免费功能：
- 安装和使用 OpenCode
- 使用内置技能
- 访问官方文档和教程
- 参与社区讨论
💰 付费功能（可选）：
- 高级第三方模型 API（如 GPT-4、Claude）
- 高级技能和插件
- 企业级支持服务

2. 模型 API 费用如何计算？

模型 API 费用由模型提供商收取，OpenCode 不收取中间费用：

模型提供商	计费方式	参考价格
OpenAI	按 token 计费	~$0.01-0.06/1K tokens
Anthropic	按 token 计费	~$0.015-0.075/1K tokens
智谱 GLM	按 token 计费	~¥0.005/1K tokens
DeepSeek	按 token 计费	~$0.0014/1K tokens

3. 如何控制 API 费用？

bash

# 设置每日限额
opencode config set limits.daily_cost 10  # 每日最多 $10

# 设置每月限额
opencode config set limits.monthly_cost 100  # 每月最多 $100

# 查看使用统计
opencode usage stats

🔧 性能与优化

1. 如何提升响应速度？

方法 1：选择响应快的模型

bash

# 使用响应速度快的模型
opencode --model deepseek-chat "写一个 Python 函数"

方法 2：优化提示词

bash

# 明确、简洁的提示词响应更快
opencode "用 Python 写一个简单的计算器函数" --no-explanation

方法 3：减少上下文

bash

# 只提供必要的上下文
opencode "分析这个函数" --file src/utils/calculator.ts --no-recursive

2. 如何处理大文件？

方法 1：分批处理

bash

# 只读取需要的部分
opencode "审查这段代码" --lines 1-100 src/large-file.ts

方法 2：使用摘要模式

bash

# 获取文件摘要而非全文
opencode "总结这个文件" src/large-file.ts --summary

🌐 网络与连接

1. 代理设置

方法 1：环境变量

bash

# Linux/macOS
export HTTP_PROXY="http://proxy.example.com:7890"
export HTTPS_PROXY="http://proxy.example.com:7890"

# Windows
set HTTP_PROXY=http://proxy.example.com:7890
set HTTPS_PROXY=http://proxy.example.com:7890

方法 2：配置文件

yaml

# ~/.opencode/config.yaml
proxy:
  http: "http://proxy.example.com:7890"
  https: "http://proxy.example.com:7890"

2. 防火墙设置

如果遇到连接问题，请检查：

✅ 确保防火墙允许 443 端口出站
✅ 确保 DNS 能正常解析模型提供商的域名
✅ 尝试使用 VPN 或代理

🔒 安全与隐私

1. API 密钥安全

✅ 安全做法：

bash

# 使用环境变量（推荐）
export OPENAI_API_KEY="sk-xxx"

# OpenCode 不会保存密钥到文件

❌ 危险做法：

bash

# 不要在命令行中直接输入密钥
opencode --api-key "sk-xxx"  # 不要这样做！

2. 数据隐私

OpenCode 的数据处理原则：

🔒 本地处理：大部分处理在本地完成
🔒 最小传输：只传输必要的内容到模型
🔒 不保存日志：默认不保存对话内容
🔒 可配置：可设置数据保留策略

bash

# 设置数据保留策略
opencode config set privacy.auto_delete_days 7

# 立即清除所有本地数据
opencode privacy clear --local

📱 多平台使用

1. Windows

powershell

# 使用 PowerShell
opencode "帮我写一个脚本"

# 使用 CMD
opencode "帮我写一个脚本"

2. macOS

bash

# 使用 Terminal
opencode "帮我写一个脚本"

# 使用 iTerm2
opencode "帮我写一个脚本"

3. Linux

bash

# 使用任意终端
opencode "帮我写一个脚本"

4. 远程服务器

bash

# SSH 连接后使用
ssh user@server
opencode "帮我写一个脚本"

🤝 协作与分享

1. 分享会话

bash

# 导出当前会话
opencode session export --output session.json

# 分享会话链接
opencode session share --file session.json

2. 团队配置

bash

# 导出团队配置
opencode config export --team > team-config.yaml

# 应用团队配置
opencode config import --team < team-config.yaml

📞 获取帮助

1. 官方渠道

渠道	地址	说明
📖 文档	docs.opencode.ai	完整使用文档
💬 Discord	discord.gg/opencode	实时社区交流
🐦 GitHub	github.com/anomalyco/opencode	问题反馈和功能建议
📧 邮件	support@opencode.ai	官方支持邮箱

2. 自助排查

bash

# 运行健康检查
opencode doctor

# 查看帮助文档
opencode --help

# 查看特定命令帮助
opencode skill --help

使用常见问题 ​

🚀 基础使用问题 ​

1. 命令行交互 ​

问题：如何启动 OpenCode 交互模式？ ​

问题：如何退出交互模式？ ​

❌ 技能使用问题 ​

1. 技能未找到 ​

错误信息 ​

解决方案 ​

🤖 模型交互问题 ​

1. 模型响应质量差 ​

问题描述 ​

解决方案 ​

📁 文件操作问题 ​

1. 文件读取失败 ​

错误信息 ​

解决方案 ​

🛠️ 故障排除工具 ​

1. 健康检查 ​

2. 日志分析 ​

🎯 常见问题解答 ​

1. 如何保存会话历史？ ​

2. 如何获取帮助？ ​

🚀 下一步 ​

使用常见问题（补充） ​

💰 费用与计费 ​

1. OpenCode 是否免费使用？ ​

2. 模型 API 费用如何计算？ ​

3. 如何控制 API 费用？ ​

🔧 性能与优化 ​

1. 如何提升响应速度？ ​

2. 如何处理大文件？ ​

🌐 网络与连接 ​

1. 代理设置 ​

2. 防火墙设置 ​

🔒 安全与隐私 ​

1. API 密钥安全 ​

2. 数据隐私 ​

📱 多平台使用 ​

1. Windows ​

2. macOS ​

3. Linux ​

4. 远程服务器 ​

🤝 协作与分享 ​

1. 分享会话 ​

2. 团队配置 ​

📞 获取帮助 ​

1. 官方渠道 ​

2. 自助排查 ​

🚀 下一步 ​

使用常见问题

🚀 基础使用问题

1. 命令行交互

问题：如何启动 OpenCode 交互模式？

问题：如何退出交互模式？

❌ 技能使用问题

1. 技能未找到

错误信息

解决方案

🤖 模型交互问题

1. 模型响应质量差

问题描述

解决方案

📁 文件操作问题

1. 文件读取失败

错误信息

解决方案

🛠️ 故障排除工具

1. 健康检查

2. 日志分析

🎯 常见问题解答

1. 如何保存会话历史？

2. 如何获取帮助？

🚀 下一步

使用常见问题（补充）

💰 费用与计费

1. OpenCode 是否免费使用？

2. 模型 API 费用如何计算？

3. 如何控制 API 费用？

🔧 性能与优化

1. 如何提升响应速度？

2. 如何处理大文件？

🌐 网络与连接

1. 代理设置

2. 防火墙设置

🔒 安全与隐私

1. API 密钥安全

2. 数据隐私

📱 多平台使用

1. Windows

2. macOS

3. Linux

4. 远程服务器

🤝 协作与分享

1. 分享会话

2. 团队配置

📞 获取帮助

1. 官方渠道

2. 自助排查

🚀 下一步