Phala Cloud Documentation — Private AI on TEE

OpenCode speaks Chat Completions. Private AI Proxy configures it automatically.

With Private AI Proxy

Install Private AI Proxy, choose a Phala profile, sign in, and turn on Protected.
On the Agents screen, connect OpenCode.
Restart OpenCode.

The app writes the provider into ~/.config/opencode/opencode.json with an agent-scoped token for its local API, and restores the file when you disconnect or stop Protected. From the CLI, the same connection is:

pap agents connect opencode

Without the Proxy

Create a key under Private AI → API Keys in the Phala dashboard. Export your Phala API key, then add a custom provider to opencode.json in your project:

export PHALA_AI_API_KEY="YOUR_PHALA_API_KEY"

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "phala": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Phala",
      "options": {
        "baseURL": "https://inference.phala.com/v1",
        "apiKey": "{env:PHALA_AI_API_KEY}"
      },
      "models": {
        "z-ai/glm-5.3": {
          "name": "GLM 5.3",
          "limit": { "context": 1048576, "output": 1048576 }
        }
      }
    }
  }
}

Start OpenCode, run /models, and select the Phala model. The key is read from the process environment. For another model, use its ID and limits from the model catalog. This path does not verify attestation locally; use Private AI Proxy or the TypeScript ACI Verifier. Every model on this endpoint runs in a TEE.

Check the Connection

Run /models and confirm a phala/ model is selected, then run one bounded tool task.

Troubleshooting

Symptom	Check
OpenCode ignores the Proxy	Confirm Connected in the app and that Protected is on, then restart OpenCode.
Phala is absent from `/models`	Confirm `provider.phala` and its `models` entry are in the project’s `opencode.json`.
No models appear	Run `opencode models phala` and read the provider error.

​With Private AI Proxy

​Without the Proxy

​Check the Connection

​Troubleshooting

​Related

With Private AI Proxy

Without the Proxy

Check the Connection

Troubleshooting

Related