OpenCode 中文社区

Appearance

1.3 网络配置 ​

对于国内用户，正确配置网络是使用 OpenCode 的关键。本节将详细介绍如何配置网络连接。

为什么需要特殊配置？ ​

由于网络原因，国内用户直接连接某些 AI 服务商可能会遇到：

  • 连接超时
  • 速度缓慢
  • 完全无法连接

OpenCode 提供了多种解决方案来应对这些问题。

方案一：使用国产模型（推荐） ​

OpenCode 原生支持多种国产模型，无需任何特殊配置：

  • 智谱 GLM-4.7 - 推荐首选
  • DeepSeek - 性价比高
  • MiniMax - 稳定快速
  • 通义千问 - 阿里出品

这些模型都有国内节点，国内用户可以直接连接。

方案二：代理配置 ​

如果需要使用 OpenAI、Claude 等海外模型，需要配置代理：

设置环境变量 ​

bash
# Linux/macOS
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"

# Windows (PowerShell)
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

在配置文件中设置 ​

编辑 ~/.config/opencode/config.yaml:

yaml
network:
  proxy:
    enabled: true
    http: "http://127.0.0.1:7890"
    https: "http://127.0.0.1:7890"

方案三：模型中转 ​

使用中转服务来连接海外模型：

Claude Code 中转 ​

yaml
providers:
  claude:
    enabled: true
    relay:
      enabled: true
      endpoint: "https://api.claude-code.com"

网络测试 ​

配置完成后，测试网络连接：

bash
opencode doctor

这个命令会检查：

  • 网络连通性
  • 代理设置
  • 模型连接

常见问题 ​

Q: 使用代理后还是连不上？ ​

A: 检查代理软件是否正常运行，端口是否正确。也可以尝试更换代理端口或代理软件。

Q: 国产模型哪个最好？ ​

A: 智谱 GLM-4.7 在性能和价格之间取得了很好的平衡，推荐作为首选。

Q: 如何判断网络是否正常？ ​

A: 运行 opencode doctor，它会详细报告网络状态。

下一步 ​

网络配置完成后，现在连接你的第一个 AI 模型：

1.4 连接模型 →

微信群