DeepCode Agent工作流

Install the runtime

Published package

With uv installed, run:

uv tool install --python 3.12 deepcode-hku
deepcode init

On Windows, you can install uv with winget install --id astral-sh.uv --exact, then open a new terminal. DeepCode requires Python 3.12 or later.

To use the native app, also install DeepCode Desktop from GitHub Releases. To try changes that have not been released yet, install from source below.

<details> <summary>Install from source</summary>

Current source checkout

You will need Git, uv, and Node.js 22 or later. Run these commands in your terminal:

git clone https://github.com/HKUDS/DeepCode.git
cd DeepCode
npm --prefix desktop ci
npm --prefix desktop run build:web
uv tool install --python 3.12 --force .
deepcode init

If you already have the repository, start in its root directory and skip cloning. You can now run deepcode from any directory. For source Desktop, also install Rust and the platform dependencies described in the Desktop guide.

</details>

If your terminal cannot find deepcode, run uv tool update-shell and open a new terminal.

Quick start

Use DeepCode to explore a repository, make changes, and run tests. Choose the terminal, desktop app, or browser—your projects and conversations are available in all three.

Your models, your reasoning settings

DeepCode is not tied to one model provider. Connect OpenRouter, OpenAI, Anthropic, DeepSeek, Gemini, an OpenAI-compatible gateway, Ollama, vLLM, or another compatible endpoint with your own API Key.

Before use, a connection can check credentials, the model catalog, and a real inference request. Each Session can choose a model and Thinking Level. Changing models mid-Session affects future Turns only; it does not delete history or confuse where earlier work came from. When supported, DeepCode can also show a reasoning summary returned by the Provider.

Configure a model

Choose either the graphical setup or the terminal commands below.

In Desktop or Web: open Settings → AI providers, select Add provider, and enter your provider's API key. Click Save and check to load its models. Under Agent model, choose a model and click Save and verify model to try a short request. Then choose the connection and model in your conversation's message box.

In your terminal: this example connects to OpenRouter. Enter your API key when prompted; it will not be displayed as you type.

deepcode provider set my-openrouter --template openrouter --api-key
deepcode provider models my-openrouter --refresh

Choose a model from the list. Replace MODEL_ID below with its exact ID and send a short test request:

deepcode provider test my-openrouter --model MODEL_ID

You can use the same connection in all three interfaces. For other providers, local models, and tool-calling checks, see Models and providers.

🖥️ **Interface Showcase**

🖥️ DeepCode Desktop

Local Plugins

Plugins optionally package Skills behind a validated local manifest; standalone project and user Skills continue to install and run without a Plugin. New packages must use the Agent Plugins 1.0.0 manifest and fixed skills/ layout. Add a trusted folder from the Desktop Plugins workspace or with `deepcode plugin add <path>`; its Skills then appear in the ordinary Skill catalog and Composer. A standards-compliant mcp.json may also contribute MCP servers; registration remains inert and those processes start only inside an Agent Session. DeepCode does not execute Plugin hooks or Apps and does not download from a Marketplace. See the local Plugin contract.