2.4 环境变量设置

OpenCode支持通过环境变量进行配置，这对于CI/CD环境和敏感信息管理特别有用。

核心环境变量

变量名	说明	示例
OPENCODE_CONFIG	自定义配置文件路径	/path/to/config.json
OPENCODE_CONFIG_CONTENT	内联JSON配置	{"model":"..."}
OPENCODE_CONFIG_DIR	配置目录路径	~/.config/opencode
OPENCODE_SERVER_PASSWORD	Web服务器密码	your-password
OPENCODE_DISABLE_AUTOUPDATE	禁用自动更新	1

API密钥环境变量

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI
export OPENAI_API_KEY="sk-..."

# Google
export GOOGLE_API_KEY="..."

# Azure
export AZURE_OPENAI_API_KEY="..."
export AZURE_OPENAI_ENDPOINT="https://..."

Claude Code兼容性

# 禁用所有Claude Code支持
export OPENCODE_DISABLE_CLAUDE_CODE=1

# 只禁用~/.claude/CLAUDE.md
export OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1

# 只禁用skills
export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1

网络代理

# HTTPS代理
export HTTPS_PROXY="https://proxy.example.com:8080"

# HTTP代理
export HTTP_PROXY="http://proxy.example.com:8080"

# 绕过代理
export NO_PROXY="localhost,127.0.0.1"

# 自定义CA证书
export NODE_EXTRA_CA_CERTS="/path/to/ca-cert.pem"

编辑器配置

# VS Code
export EDITOR="code --wait"

# Vim
export EDITOR="vim"

# Nano
export EDITOR="nano"

配置示例

在 ~/.bashrc 或 ~/.zshrc 中：

# OpenCode配置
export ANTHROPIC_API_KEY="sk-ant-your-key"
export EDITOR="code --wait"
export OPENCODE_DISABLE_AUTOUPDATE=1

# 代理设置（可选）
export HTTPS_PROXY="http://proxy:8080"
export NO_PROXY="localhost,127.0.0.1"

配置文件中引用环境变量

{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}"
      }
    }
  }
}

下一步

基础配置完成后，接下来学习OpenCode的界面操作。