常见问题解答

##基础问题

###什么是OpenCode？

OpenCode是一个在终端中运行的AI编程助手。它使用Claude、GPT和Gemini等先进语言模型帮助你编写、调试、重构和理解代码。

###OpenCode与其他AI编程工具有什么不同？

OpenCode专为终端工作流设计：

• 原生CLI：为喜欢命令行界面的开发者打造
• 多模型支持：在不同AI提供商之间无缝切换
• 上下文感知：理解整个代码库，不仅是打开的文件
• 可扩展：插件系统支持自定义集成
• 注重隐私：你的代码保留在本地

###OpenCode免费使用吗？

OpenCode本身是开源免费的。但是，你需要AI提供商（Anthropic、OpenAI、Google）的API密钥，它们有各自的定价。许多提供商为个人使用提供免费额度。

###OpenCode支持哪些编程语言？

OpenCode支持任何编程语言。它在以下语言表现出色：

• 强力支持：JavaScript、TypeScript、Python、Go、Rust、Java、C++
• 良好支持：Ruby、PHP、Swift、Kotlin、C#、Scala
• 基本支持：任何基于文本的编程语言

##安装与设置

###系统要求是什么？

• 操作系统：macOS 10.15+、Linux（大多数发行版）、Windows（WSL2）
• 内存：最低512MB RAM
• 存储：OpenCode 100MB + 模型缓存
• 网络：API调用需要网络连接（或使用本地模型）

###如何安装OpenCode？

最快的方法：

curl -fsSL https://opencode.ai/install.sh | sh

查看我们的安装指南了解所有安装方式。

###如何设置API密钥？

将API密钥设置为环境变量：

# Claude
export ANTHROPIC_API_KEY="your-key-here"

# GPT
export OPENAI_API_KEY="your-key-here"

# Gemini
export GOOGLE_API_KEY="your-key-here"

添加到shell配置文件（~/.zshrc或~/.bashrc）使其永久生效。

###可以离线使用OpenCode吗？

可以，通过Ollama使用本地模型：

# 安装Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取模型
ollama pull codellama

# 在OpenCode中使用
opencode --model ollama:codellama

##使用问题

###如何开始使用OpenCode？

1. 打开终端
2. 导航到项目目录
3. 运行 opencode
4. 开始对话！

cd my-project
opencode

###如何引用特定文件？

使用 @ 提及引用文件：

@src/utils.ts 添加一个日期格式化函数
@package.json 更新版本到2.0.0

###如何在AI模型之间切换？

会话中：

/model claude-opus-4-20250514

或启动时指定模型：

opencode --model gpt-4o

###如何撤销OpenCode做的更改？

使用撤销命令：

/undo

这会撤销上次文件修改。多次撤销可以使用git：

git checkout -- <file>

###OpenCode可以在系统上运行命令吗？

可以，需要你的批准。OpenCode在执行任何shell命令前会请求权限。你可以在设置中配置安全命令的自动批准。

##计费与定价

###OpenCode多少钱？

OpenCode免费开源。你只需支付AI API使用费：

| 提供商 | 模型 | 大约成本 | |--------|------|----------| | Anthropic | Claude Sonnet | ~$3/百万tokens | | Anthropic | Claude Opus | ~$15/百万tokens | | OpenAI | GPT-4o | ~$5/百万tokens | | OpenAI | GPT-4o-mini | ~$0.15/百万tokens | | Google | Gemini Flash | ~$0.075/百万tokens | | 本地 | Ollama | 免费（你的硬件） |

###如何跟踪API成本？

会话中使用成本命令：

/cost

或查看提供商的控制面板获取详细账单。

###有使用限制吗？

限制取决于你的API提供商：

• Anthropic：根据等级的速率限制
• OpenAI：根据等级和模型的速率限制
• Google：慷慨的免费额度，然后按用量付费

##安全与隐私

###我的代码会发送到外部服务器吗？

使用云模型时，代码上下文会发送到AI提供商的API。为获得最大隐私：

1. 通过Ollama使用本地模型
2. 配置上下文排除
3. 使用 .opencodeignore 排除敏感文件

###如何排除敏感文件？

在项目根目录创建 .opencodeignore：

# 排除敏感文件
.env*
*.pem
*.key
secrets/
credentials/

###OpenCode符合SOC 2标准吗？

对于有合规要求的企业部署，请联系我们了解带审计日志和合规功能的企业版。

###我的对话会被存储吗？

• 本地：会话历史存储在 ~/.opencode/history/
• API提供商：查看各提供商的数据保留政策
• OpenCode服务器：我们不存储任何你的代码或对话

##故障排除

###安装后"命令未找到"

1. 重启终端
2. 检查二进制文件是否在PATH中：
   bash

   which opencode
   

3. 如需要手动添加到PATH：
   bash

   export PATH=$PATH:/usr/local/bin
   

###"API密钥无效"错误

1. 验证API密钥正确
2. 检查环境变量：
   bash

   echo $ANTHROPIC_API_KEY
   

3. 确保没有多余的空格或引号

###"上下文长度超限"错误

你的对话或文件上下文太大。解决方案：

1. 使用 /compact 压缩对话
2. 用 /clear 开始新会话
3. 切换到更大上下文的模型（Gemini 200万）
4. 从上下文中排除不必要的文件

###OpenCode很慢

1. 检查网络：API调用需要网络
2. 尝试更快的模型：使用Haiku或GPT-4o-mini
3. 减少上下文：排除不必要的文件
4. 使用本地模型：消除网络延迟

###文件更改未保存

1. 检查文件权限
2. 验证磁盘空间
3. 确保不在只读模式
4. 检查文件是否被其他进程锁定

##功能

###OpenCode支持语音输入吗？

语音输入在2025年路线图中。目前，你可以使用操作系统的语音转文字功能配合OpenCode。

###OpenCode可以生成图片或图表吗？

OpenCode专注于代码生成。对于图表，它可以生成：

• Mermaid图表代码
• PlantUML规范
• ASCII艺术图表

###OpenCode有IDE集成吗？

VS Code和JetBrains扩展计划在2025年第一季度推出。目前，OpenCode作为独立终端工具效果最好。

###可以在团队项目中使用OpenCode吗？

可以！OpenCode可以与任何git仓库配合使用。共享配置等团队功能计划在2025年第二季度推出。

##贡献

###如何为OpenCode做贡献？

我们欢迎贡献！

1. 代码：在GitHub提交PR
2. 文档：帮助改进我们的文档
3. 插件：创建和分享插件
4. 社区：在Discord帮助他人

###在哪里报告Bug？

在我们的GitHub Issues页面报告问题。包含：

• OpenCode版本（opencode --version）
• 操作系统
• 复现步骤
• 错误消息

###如何请求功能？

1. 查看现有的功能请求
2. 创建带"enhancement"标签的新issue
3. 描述你的使用场景和建议方案

##获取帮助

###在哪里可以获得支持？

• 文档：你已经在这里了！
• Discord：加入我们的社区
• GitHub：Issues和讨论
• 邮箱：support@opencode.ai

###有社区吗？

有！加入我们活跃的社区：

• Discord：实时聊天和支持
• GitHub Discussions：长篇讨论
• Twitter/X：@OpenCodeAI 获取更新
• Reddit：r/opencode

##还有问题？

找不到你要的答案？

1. 搜索我们的文档
2. 在Discord提问
3. 提交GitHub issue
4. 发邮件到 support@opencode.ai

我们随时为你提供帮助！