Deepseek.ai is an independent website and is not affiliated with, sponsored by, or endorsed by Hangzhou DeepSeek Artificial Intelligence Co., Ltd.

    Agent integrations · August 2, 2026 · Independent Guide

    Reasonix: The DeepSeek-Native Coding Agent That Lives in Your Terminal

    By the Deep Seek AI editorial desk · August 2, 2026 · 7 min read

    DeepSeek's agent-integrations documentation now lists Reasonix — a coding agent written for DeepSeek's own API rather than bolted onto an OpenAI-compatible shim. One command, npx reasonix code, and you have an agent in your project directory running on DeepSeek-V4-Flash by default. Here is what it is, how to set it up, and what a session actually costs.

    The 60-second version

    • Terminal-first, DeepSeek-first. Reasonix talks to api.deepseek.com directly — no translation layer between the agent and the model.
    • Three-step setup. Node.js 20.10+, an API key from the DeepSeek Platform, then npx reasonix code in your project folder.
    • No global install, no env var. A first-run wizard stores your key in ~/.reasonix/config.json.
    • Flash-first cost control. V4-Flash is the default; /pro arms V4-Pro for one turn, /preset max for the whole session.
    • Cache-first loop and automatic tool-call repair are the two design choices that make a long agent session survivable — both technically and financially.

    Why "DeepSeek-native" is not just marketing

    Almost every popular coding agent was designed for a different vendor's API and reaches DeepSeek through the OpenAI-compatible endpoint. That works, but it flattens everything DeepSeek does differently. Two things get lost in particular:

    • Context caching. DeepSeek bills cache hits at a fraction of the cache-miss rate. An agent that does not deliberately structure its prompts to hit the cache throws that discount away on every turn. Reasonix is built around a cache-first loop, which is exactly the right optimisation target for an agent that re-sends a large, mostly-identical project context dozens of times.
    • Tool-call behaviour. Model-specific quirks in function calling are usually patched with retries in generic agents. Reasonix advertises automatic tool-call repair — it fixes malformed calls instead of burning a whole turn on them.

    Setup: three steps, about two minutes

    1. Install Node.js

    You need Node.js 20.10 or newer. On Windows you also need Git for Windows, since the agent shells out to git for its file operations.

    2. Get a DeepSeek API key

    Create a key at platform.deepseek.com/api_keys. You do not need to export it: the first run of Reasonix prompts for the key through a built-in wizard and writes it to ~/.reasonix/config.json. That is convenient, and it is also worth knowing — that file is a plaintext credential on your disk, so treat it like an SSH key and keep it out of any synced folder or repo.

    3. Run it in your project

    cd /path/to/my-project
    npx reasonix code

    npx means no global install and no version pinned in your toolchain — you get the current release each time. The agent scopes itself to the directory you launch it in, so launch it at the repo root you actually want it editing.

    Model control: Flash by default, Pro on demand

    This is the part that matters most for your bill. Reasonix defaults to DeepSeek-V4-Flash for cost-efficient iteration and gives you explicit escalation instead of silently spending Pro money:

    CommandEffect
    /proArms DeepSeek-V4-Pro for the next turn only, then falls back to Flash.
    /preset maxUses V4-Pro for the whole session — highest quality, highest cost.
    /helpFull slash-command reference inside the TUI.

    The practical workflow: stay on Flash for exploration, file reading, mechanical edits and test loops. Reach for /pro on the single turn where the reasoning is genuinely hard — an architectural refactor, a subtle concurrency bug, a migration plan. Reserve /preset max for sessions where every turn is that hard.

    What a session costs

    Current DeepSeek API rates per 1M tokens, straight from our pricing reference:

    ModelInput (cache miss)Input (cache hit)Output
    DeepSeek-V4-Flash (default)$0.14$0.0028$0.28
    DeepSeek-V4-Pro (/pro)$0.435$0.003625$0.87

    The cache-hit column is the whole game for a terminal agent. Your project context is re-sent on every turn, so a cache-first agent pays the miss rate roughly once and the hit rate thereafter. A peak-hour surcharge has been announced but is not active yet — the official rate card still shows one flat tier.

    Two things to check before you let it run

    • Commit first. A terminal agent edits real files. Start from a clean git tree so every change it makes is reviewable with git diff.
    • Reasonix is third-party. DeepSeek documents it as a supported integration; it is not a DeepSeek product. You are handing an independent tool an API key and write access to your source, so read the project's own docs before pointing it at anything sensitive.

    Where it fits next to the rest of the DeepSeek agent story

    This lands right after the official V4-Flash release on July 31, 2026, which was explicitly an agent upgrade: fresh post-training, native Responses API support and Codex adaptation, with agent benchmark scores passing V4-Pro-Preview. A Flash-first terminal agent only makes sense because the cheap tier is now genuinely good at multi-step tool use. If you want the model-side detail first, start with our DeepSeek V4 overview and the DeepSeek API guide.

    Frequently asked questions

    What is Reasonix?

    Reasonix is a DeepSeek-native coding agent that runs in your terminal. It talks to api.deepseek.com directly — without an OpenAI-compatibility translation shim — and is built around a cache-first request loop, flash-first cost control and automatic tool-call repair. DeepSeek lists it in the agent-integrations section of its official API documentation.

    How do I install Reasonix for DeepSeek?

    Install Node.js 20.10 or newer (Windows users also need Git for Windows), get an API key from platform.deepseek.com/api_keys, then run `cd /path/to/my-project` followed by `npx reasonix code`. No global install is required. On first run a built-in wizard prompts for the key and persists it to ~/.reasonix/config.json, so you do not need to export an environment variable.

    Which DeepSeek model does Reasonix use by default?

    DeepSeek-V4-Flash. That is the cheap, fast tier, which is what makes a terminal agent affordable to run for hours of iteration. Type /pro inside the TUI to arm DeepSeek-V4-Pro for the next turn only, or /preset max to use Pro for the entire session.

    What does a Reasonix session cost?

    On the default Flash tier, DeepSeek-V4-Flash is $0.14 per 1M input tokens on a cache miss, $0.0028 on a cache hit and $0.28 per 1M output tokens. Because Reasonix is cache-first, repeated context in a long session is billed largely at the cache-hit rate. Switching to V4-Pro raises that to $0.435 / $0.003625 input and $0.87 output per 1M tokens. A peak-hour surcharge has been announced but is not active yet — the official rate card still shows one flat tier.

    Is Reasonix made by DeepSeek?

    No. Reasonix is a third-party open-source project that DeepSeek documents as a supported agent integration. DeepSeek supplies the models and the API; the agent itself is maintained independently. This guide is likewise an independent fan-run resource and is not affiliated with DeepSeek.

    How is Reasonix different from using DeepSeek through Codex or Cline?

    Most coding agents were written for another vendor's API and reach DeepSeek through an OpenAI-compatible endpoint. Reasonix targets api.deepseek.com natively, so it can lean on DeepSeek-specific behaviour such as context caching and its own tool-call repair rather than treating DeepSeek as a drop-in substitute.

    Source: DeepSeek's official agent-integrations documentation for Reasonix (api-docs.deepseek.com). This is an independent fan-run guide and is not affiliated with DeepSeek or with the Reasonix project.