Opencode

Opencode is a provider-agnostic AI coding assistant that works in your terminal. Use varlock to inject provider API keys at runtime.

For install, schema setup, and shared patterns, see the AI Tools overview.

Environment variables:

• ANTHROPIC_API_KEY for Claude models
• OPENAI_API_KEY for OpenAI models
• OPENCODE_CONFIG path to custom config file (optional)

Auth configuration

Run opencode auth login once. When prompted for an API key, paste an env reference instead:

{"env:ANTHROPIC_API_KEY"}

Your config file (~/.local/share/opencode/auth.json) should look like:

~/.local/share/opencode/auth.json

{
  "anthropic": {
    "type": "api",
    "key": "{env:ANTHROPIC_API_KEY}"
  }
}

In a project

Add to .env.schema:

# @sensitive @required
ANTHROPIC_API_KEY=op(op://api-local/anthropic/api-key)

# @sensitive
OPENAI_API_KEY=op(op://api-local/openai/api-key)

Tip

You can use any secrets provider you want, but we like 1Password since it uses biometric authentication for local access. All the examples in this guide use the 1Password plugin (op()) to show more real world examples. See that page for plugin setup and auth options.

varlock run -- opencode

# or with a specific model
varlock run -- opencode --model claude-3-5-sonnet

From any directory

Personal schema at ~/.env.opencode:

~/.env.opencode

# @sensitive @required
ANTHROPIC_API_KEY=op(op://api-local/anthropic/api-key)

# @sensitive
OPENAI_API_KEY=op(op://api-local/openai/api-key)

varlock run -p ~/.env.opencode -- opencode

# or with a specific model
varlock run -p ~/.env.opencode -- opencode --model claude-3-5-sonnet

Shell alias (optional)

alias vopencode='varlock run -p ~/.env.opencode --no-redact-stdout -- opencode'

See the Opencode docs for more information.