How to Use Phi-4 in opencode
Phi-4 suits math problems, logic checks, and Python code tasks. Its 14-billion-parameter model has a 16K-token context window; use English prompts and check factual claims against supplied sources.
Prompts to try with Phi-4 in opencode
Copy an example into opencode, or ask in your own words.
Use Phi-4 to review the project's Python percentage-change calculation. Find a concrete input that exposes a bug, propose the smallest correction, and add a regression test with a verified expected result.
Use Phi-4 to draft a Python helper that groups the project's event records by day using datetime and collections. Read the existing data structures first, preserve the project's timezone convention, and test empty input and a midnight boundary.
Use Phi-4 to inspect the project's weighted-average function. Compare its behavior with the documented formula, check zero total weight, and propose a correction only if you can demonstrate a mismatch.
Use Phi-4 to propose boundary tests for the project's Python date-range utility. Cover leap day, month end, and reversed dates, then verify the expected results before adding tests.
Use Phi-4 to review one Python function touched by the current diff. Supply only the function, its relevant callers, and its intended behavior; return up to three logic concerns with concrete examples.
How to set up Phi-4 in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Phi-4
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "openrouter", "model": "microsoft/phi-4", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: opencode finds Phi-4 on Spiral, shows the price and runs it.
Phi-4 providers and prices
Spiral runs Phi-4 through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.000749 per run at the default inputs. $0.091 per 1M input tokens, $0.182 per 1M output tokens.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | ||
| Min p | 0 to 1 | ||
| Top k | a whole number from 0 | ||
| Top p | 0 to 1 | ||
| Max tokens | 1 to 14745 | The most output tokens to generate. | |
| Temperature | 0 to 2 | ||
| Presence penalty | -2 to 2 | ||
| Frequency penalty | -2 to 2 | ||
| Repetition penalty | 0 to 2 |
Every API field of Microsoft: Phi 4 is on its tool page: open its card above.
What can you do with Phi-4 in opencode?
Use Phi-4 to draft Python helpers, inspect calculation logic, and propose focused tests from project code. Give it a small, self-contained task, then run the proposed code and check unfamiliar APIs.
Check business calculations
Ask Phi-4 to review percentage changes, weighted averages, and unit conversions using supplied numbers. Request the formula and a short calculation you can verify.
Draft small Python utilities
Use Phi-4 to draft focused functions for counting records, grouping values, or calculating summary statistics. Specify the input, expected result, and edge cases.
Review Python logic
Give Phi-4 a function and its intended behavior. Ask for a failing example and a proposed correction, then run the example yourself.
Propose Python test cases
Ask Phi-4 for normal, boundary, and invalid-input cases for a small function. Review the expected results before adding the tests.
Explain math mistakes
Provide a problem and an attempted solution. Ask Phi-4 to identify the first incorrect step and explain a correction at the learner's level.
Check plans against constraints
Supply scheduling rules, dependencies, and resource limits. Ask Phi-4 to identify conflicts and propose a plan that satisfies the stated constraints.
Work through science exercises
Provide an exercise, its assumptions, and any required reference material. Ask Phi-4 for a concise explanation with equations, units, and a check of the result.
More on Phi-4 and opencode
Overview
Phi-4 in other agents
Questions about Phi-4 in opencode
Can opencode use Phi-4?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Phi-4 like any built-in tool.
How much does Phi-4 cost in opencode?
Up to $0.000749 per run at the default inputs. $0.091 per 1M input tokens, $0.182 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need an OpenRouter account to use Phi-4 in opencode?
No. Spiral runs Phi-4 on its own OpenRouter account. You sign in to Spiral once and never paste a key.
How long does it take to set up Phi-4 in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Phi-4 runs?
Phi-4 runs in the background. opencode starts the run, checks on it and gives you the text, json when it's ready.
What is Phi-4 good at?
Mathematical reasoning is a documented strength. Try it for checking calculations, solving constrained problems, and explaining a mathematical solution.
How much text can Phi-4 handle?
Phi-4 has a 16K-token context window. Keep the instructions, relevant conversation, source material, and requested response within that budget.
Which language should I use with Phi-4?
Use English when possible. Microsoft says performance is worse in other languages, so evaluate your actual tasks before relying on multilingual output.
Is Phi-4 useful for coding?
Python is the best-supported starting point in its documented code training. Check generated code against tests, and verify unfamiliar packages or APIs against their documentation.
Can I trust Phi-4's factual answers and formatting?
Phi-4 can invent factual details and miss strict formatting requirements. Supply the evidence you want it to use, check claims against that evidence, and validate outputs before a program consumes them.
Start using Phi-4 in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


