DeepSeek 终端助手接入
DeepSeek 终端助手接入
Qwen Code 接入
2 分钟阅读
接入 Qwen Code
Qwen Code 是阿里巴巴通义千问团队开发的开源 AI 终端助手，核心优势在于轻量高效、集成丰富的编码工具、支持多模型切换、深度适配国内开发者使用习惯，支持代码生成、调试、解释、重构全流程能力，适合日常编码、技术学习、文档生成等全场景需求。
DeepSeek 已经作为内置第三方提供商集成在 Qwen Code 中——你只需要带上自己的 API Key 即可使用，无需手动配置接口地址、兼容参数等复杂内容，接入后可充分利用 DeepSeek V4 的强推理能力和百万上下文窗口，大幅提升编码效率。
本教程将带你完成从安装到配置 DeepSeek 的全流程，看完即可快速在 Qwen Code 中使用 DeepSeek 模型进行编码工作。
- GitHub: https://github.com/QwenLM/qwen-code
- 文档: https://qwenlm.github.io/qwen-code-docs/zh/users/overview/
1. 安装 Qwen Code
操作目的：完成 Qwen Code 基础环境部署，获取 qwen 可执行命令。
-
安装 Node.js 20 或更高版本。 操作说明：Qwen Code 依赖 Node.js 20+ 的新特性，低版本会安装失败，安装完成后执行
node -v确认版本 ≥ 20。 -
安装 Qwen Code： 三种安装方式可根据你的环境选择：
- npm 安装（适合已有 Node.js 环境的开发者，方便后续升级）
若安装时提示权限不足，Linux/macOS 用户可添加
sudo，Windows 用户需以管理员身份运行 PowerShell。- 快速安装脚本（适合无 Node.js 环境的用户，自动下载原生二进制包）
- Homebrew 安装（适合 macOS 用户，通过包管理器统一管理）
-
验证安装结果：
正常输出版本号即为安装成功。
2. 获取 DeepSeek API Key
操作目的：获取调用 DeepSeek 接口的身份凭证，用于 Qwen Code 访问 DeepSeek 服务时的身份认证。 前往 DeepSeek Platform，注册账号后创建并复制 API Key，创建时建议设置合理的有效期与调用限额，遵循最小权限原则，仅开启对话相关权限，降低 Key 泄露后的风险。 注意事项：API Key 是敏感信息，请勿分享给他人，也不要提交到公开的代码仓库中。
3. 通过 /auth 配置 DeepSeek
操作目的：通过 Qwen Code 内置的认证向导完成 DeepSeek 提供商的配置，无需手动修改配置文件。
启动 Qwen Code，然后运行 /auth 命令：
操作说明：启动 Qwen Code 交互会话，预期结果为显示 Qwen Code 欢迎语与命令提示。
进入交互会话后：
操作说明：打开认证配置菜单，用于配置第三方模型提供商的身份信息。
将出现认证菜单，按以下步骤操作：
- 选择 Third-party Providers 操作说明：进入第三方提供商配置界面，DeepSeek 作为内置第三方提供商在此处配置。
- 选择 DeepSeek API Key 操作说明：指定要配置的提供商为 DeepSeek，系统会自动加载 DeepSeek 的官方接口配置，无需手动填写地址等参数。
- 步骤 1/2 — 粘贴你的 DeepSeek API Key，回车 操作说明：输入你在 DeepSeek 开放平台获取的 API Key，完成身份认证。
- 步骤 2/2 — 确认模型 ID：
deepseek-v4-pro, deepseek-v4-flash（可自行修改），回车 操作说明：指定 Qwen Code 要加载的 DeepSeek 模型，默认值为官方支持的两个模型，无需修改，若有自定义部署的模型可在此处调整。
确认后将显示：Successfully configured DeepSeek API Key，说明配置已生效。
4. 切换到 DeepSeek 模型
操作目的：将当前会话的默认模型切换为 DeepSeek 模型，即可开始使用。
运行 /model 命令，打开模型选择菜单：
选择 deepseek-v4-pro 或 deepseek-v4-flash，切换成功后会提示模型已变更。
大功告成。Qwen Code 将使用 DeepSeek V4 模型进行编码。
提示： 随时使用
/model切换模型，使用/auth重新配置 API Key，也可以通过/switch deepseek-v4-flash命令快速切换模型，无需打开菜单。
使用技巧与最佳实践
- 日常简单需求使用
deepseek-v4-flash，响应速度更快，成本更低；复杂任务使用deepseek-v4-pro，推理能力更强。 - 进入项目目录后启动 Qwen Code，会自动加载当前项目的代码作为上下文，生成的代码会适配项目的技术栈与规范。
- 可通过
/set default-model deepseek-v4-flash命令设置默认模型，每次启动 Qwen Code 自动加载，无需每次切换。
常见问题（FAQ）
/auth菜单中找不到 DeepSeek 选项？ 排查步骤：执行qwen --version确认版本为最新版，执行npm install -g @qwen-code/qwen-code@latest升级到最新版本即可。- 配置完成后调用模型返回 401 未授权？ 排查步骤：检查输入的 API Key 是否正确，无多余空格或换行，前往 DeepSeek 开放平台确认 Key 状态正常且有可用余额。
- 模型列表中找不到 DeepSeek 模型？
排查步骤：重新执行
/auth命令，检查步骤 2/2 中的模型 ID 是否为deepseek-v4-pro, deepseek-v4-flash，逗号分隔且无多余字符。