Last checked: 2026-06-03

FAQ

Reasonix frequently asked questions

Use this page to separate download paths, version status, account login, and Chinese-user setup questions that are easy to confuse.

How is Reasonix different from a generic OpenAI-compatible CLI?

Reasonix emphasizes DeepSeek-native behavior, prefix-cache stability, flash-first cost control, and automatic tool-call repair. It is not just another CLI with a model name changed.

Where should I run npx reasonix code for the first time?

Run it inside the project directory you want Reasonix to read and edit. That keeps file context, command output, and project memory tied to the correct repository.

What should I check before the first run?

Check node -v, npm -v, npm view reasonix engines, and npm view reasonix dist-tags. The npm package currently declares Node >=22, so prefer live package metadata when older guides disagree.

Should I use npx, global npm install, or build from source?

Use npx reasonix code for first-time testing, npm i -g reasonix when you want a reusable local command, and a main-v2 source build only when you need to inspect, patch, or verify current commits.

Why are npm latest and npm next different?

As of 2026-06-04, npm latest is 0.53.2 and npm next is 1.1.0. Unpinned npm and npx commands use latest by default; use an explicit tag only when you intentionally want that line.

Does the login page store my API key?

No. The login page uses Clerk for a site account session. DeepSeek API keys should stay in your own environment variables or local Reasonix config.

Where should my DeepSeek API key live?

Keep it in the local Reasonix setup, your shell environment, or a local secret manager. Do not paste provider keys into community posts, screenshots, public issues, or repository commits.

What if npx reasonix code starts the wrong version?

Run npm view reasonix dist-tags, verify npm cache, and pin reasonix@latest or reasonix@next only when you mean that tag. If a global install shadows npx, check your PATH and npm global bin directory.

What if the reasonix command is not found?

Use npx reasonix code without a global install, or reinstall the global package and confirm that npm's global bin directory is on PATH. Also confirm you are in the intended project directory.

When should I use /help, /pro, or /preset max?

Start with /help to inspect available commands. Use /pro for a single stronger reasoning turn, and /preset max when a whole session needs the stronger model setting.

What projects are a good fit for Reasonix?

Reasonix is most useful in local code repositories where a DeepSeek-native agent can read files, run commands, and keep a long working context. It is less useful for short one-off prompts that do not need project state.

What details should I include in a support question?

Include the command, operating system, node -v, npm -v, selected npm tag, and a short error summary. Remove API keys, tokens, private repository URLs, and full environment dumps before posting.