DeepSeek V4 + Claude Code 鸿蒙 APP 开发实践指南

本文记录如何基于 DeepSeek V4 大模型,通过 Claude Code + CC-Switch 搭建高效的 HarmonyOS 应用开发环境,并配置鸿蒙专属 Skill 提升编码效率。


1. 为什么选这套方案?

Claude Code 是我目前最推荐的 AI 编程工具之一,尤其适配鸿蒙 APP 开发场景。它的上手曲线略陡,但一旦完成安装、接入模型、定好规范,你会发现它远不止是一个对话窗口——它能直接帮你写 ArkTS 代码、跑鸿蒙编译命令、跨文件重构鸿蒙项目组件,是一个真正能替你动手的代理工具,完美解决鸿蒙开发中语法复杂、组件适配繁琐、多步骤操作耗时的痛点。
DeepSeek V4 的发布,让这套工具链拥有了前所未有的性价比,也让鸿蒙开发者无需再为“高效开发”付出高昂成本。

参考 DeepSeek 官方定价:

在这里插入图片描述

在这里插入图片描述

单看 API 定价也许不会立刻感到便宜,但 DeepSeek V4 真正的杀手锏是极高的缓存命中率——轻松达到 95%+。这意味着大量重复或相似的鸿蒙开发请求(如重复调用 ArkTS 语法、复用组件代码、频繁调试同一功能)几乎不产生新开销,10 块钱就能支撑长时间的轻度鸿蒙开发使用。配合鸿蒙开发相关的 Skill 和 MCP,你不再需要在“能力”和“成本”之间做任何妥协,百万上下文也不再是高端订阅才有的特权,而成了你本地终端的标准配置,可轻松承载整个鸿蒙项目代码库,大幅提升开发效率。


2. DeepSeek V4 介绍

DeepSeek V4 是 DeepSeek 于 2026 年 4 月正式发布并开源的新一代大语言模型系列,包含两个版本:

版本 参数规模 激活参数 上下文长度 定位
V4-Pro 1.6T 49B 1M token 旗舰编程模型
V4-Flash 284B 13B 1M token 快速响应模型

核心亮点

  • Agent Coding 能力显著增强:内部评测体验优于 Claude Sonnet 4.5,交付质量接近 Opus 4.6 非思考模式
  • 百万上下文成标配:引入全新 DSA2 稀疏注意力机制(结合 CSA 和 HCA),在 1M 上下文场景下推理计算量仅为 V3.2 的 27%,KV 缓存降至 10%
  • 国产芯片适配:首次在华为昇腾(Ascend)NPU 上完成适配验证,打破英伟达 CUDA 生态垄断
  • 极低定价:V4-Pro 每百万 token 输入约 1 美元,V4-Flash 更低,约为美国顶级模型的五分之一
  • 专为 Agent 优化:API 同时支持 OpenAI ChatCompletions 接口与 Anthropic 接口,专项适配 Claude Code、OpenClaw、OpenCode、CodeBuddy 等主流 Agent 产品

参考:DeepSeek V4 发布解读


3. Claude Code 介绍

Claude Code 是 Anthropic 推出的 AI 编程命令行工具(CLI Agent),核心能力包括:

  • 代码理解与生成:在终端内直接与 AI 对话,自动完成编程任务
  • 工具调用(Tool Use):可自动执行读写文件、搜索代码、运行命令等操作
  • Agent 模式:能自主规划和执行复杂的多步骤任务
  • Skill 机制:支持通过 Skill 扩展领域知识,实现特定技术栈的深度辅助
  • 多供应商支持:通过环境变量可接入任何兼容 Anthropic API 的模型供应商(如 DeepSeek)

Claude Code 的设计哲学是 “AI 不再只是一个对话窗口,而是一个可以直接帮你写代码、改代码、跑命令的代理工具”,特别适合需要频繁上下文切换的开发场景。

官方文档:Claude Code


4. CC-Switch 介绍

CC-Switch 是一款开源的 Claude Code / Codex / Gemini CLI 图形化配置管理工具(GitHub 5900+ stars),用于一站式管理不同大语言模型供应商的 API 配置。

核心功能

功能 说明
供应商管理 内置 17+ 预设供应商模板(DeepSeek、智谱GLM、MiniMax、PackyAPI 等)
一键切换 图形化界面切换模型,Claude Code 热重载即时生效
配置可视化 无需手动编辑 JSON,降低配置出错风险
健康检查 配置完成后可验证 API 连通性
MCP 管理 支持 Model Context Protocol 服务器的增删改查
Skills 管理 图形化管理 Skills 的启用与禁用
云同步 通过坚果云 / OneDrive / Dropbox 实现多设备配置同步
系统提示词 支持自定义系统级 Prompt

技术栈

  • 前端:Tauri 2.8 + React 18 + TypeScript
  • 后端:Rust + SQLite
  • 跨平台:macOS / Windows / Linux / WSL

项目地址:cc-switch | 使用教程


5. 安装与配置说明

5.1 安装 Node.js 环境

Claude Code 依赖 Node.js 运行,推荐使用 LTS 版本(>= 18.x)。

macOS / Linux

# 检查是否已安装
node --version

# 使用 Homebrew 安装(macOS)
brew install node

# 使用 nvm 管理多版本(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
nvm use --lts

Windows

  • Node.js 官网 下载 LTS 版本安装包
  • 或使用 winget 安装:
winget install OpenJS.NodeJS.LTS

5.2 安装 Claude Code

macOS 安装

安装 Claude Code(使用 npm):

npm install -g @anthropic-ai/claude-code

验证安装

claude --version
Windows 安装

Windows 必须先装 Git,因为 Claude Code 底层用 Git Bash 执行命令。

装 Git(如果已有可跳过):

winget install Git.Git

安装 Claude Code(使用 npm):

npm install -g @anthropic-ai/claude-code

配置 PATH(非常重要):
Claude Code 的可执行文件默认在 C:\Users\你的用户名\.local\bin
把这个路径加到系统环境变量的 Path 里:

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到「Path」→「编辑」→「新建」
  3. 粘贴路径 C:\Users\你的用户名\.local\bin
  4. 必须重启终端才能生效

验证安装

claude --version

安装后首次运行 claude,会进入交互式编程环境。退出方式为 /exit

5.3 安装 CC-Switch

macOS

brew tap farion1231/ccswitch
brew install --cask cc-switch

首次打开 macOS 若提示"无法验证开发者",前往「系统设置 → 隐私与安全性 → 仍要打开」即可。

Windows(推荐):

  • GitHub Releases 下载最新的 CC-Switch-v*-Windows.msi
  • 双击安装,按向导完成
  • 安装完成后自动创建桌面快捷方式

Linux

# 下载 .deb 或 .AppImage 文件安装
# .deb 安装:sudo dpkg -i cc-switch_*.deb
# .AppImage:chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

5.4 获取 DeepSeek API Key

  1. 访问 DeepSeek API 开放平台
  2. 注册 / 登录账号(支持邮箱、手机号注册)
  3. 进入「API Keys」页面 → 点击「Create New API Key」
  4. 立即保存!Key 仅显示一次,格式为 sk-xxxxxxxx
  5. 确保账户有可用余额(通常充值 10 元即可满足长期使用)

安全提醒:API Key 是你的个人凭证,不要分享给他人,不要提交到代码仓库。

5.5 CC-Switch 配置 DeepSeek 模型

在这里插入图片描述

  1. 打开 CC-Switch 桌面应用
  2. 在顶部标签栏选择 「Claude Code」
  3. 点击右上角 「+」 按钮新建配置
  4. 在这里插入图片描述
    在这里插入图片描述

注意:deepseek-v4-pro[1m]和deepseek-v4-flash模型可以按自己需求修改配置

  1. 选择 DeepSeek 预设模板,或手动填写以下参数:
配置项 推荐值 说明
Base URL https://api.deepseek.com/anthropic DeepSeek Anthropic 兼容端点
认证类型 ANTHROPIC_AUTH_TOKEN 固定值
API Key sk-xxxxxxxx 你的 DeepSeek API Key
主模型 deepseek-v4-pro[1m] 必须带 [1m] 才能激活百万 Token 上下文
默认 Opus 模型 deepseek-v4-pro[1m] 高端任务模型
默认 Sonnet 模型 deepseek-v4-pro[1m] 均衡任务模型
默认 Haiku 模型 deepseek-v4-flash 快速任务模型
子代理模型 deepseek-v4-flash 子任务模型
努力程度 max CLAUDE_CODE_EFFORT_LEVEL
API 超时 3000000(50 分钟) 防止复杂任务超时
  1. 点击 「健康检查」 验证配置连通性
  2. 启用该配置(点击启用开关)
  3. Claude Code 会自动热重载,无需重启终端

5.6 手动配置方式(settings.json)

如果你不使用 CC-Switch,也可以直接编辑 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

macOS / Linux 等效环境变量(写入 ~/.bashrc~/.zshrc):

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Windows 等效环境变量(PowerShell,写入 $PROFILE):

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

注意:两种方式二选一即可,CC-Switch 本质也是写入 settings.json。混合使用时以文件配置为准。

5.7 验证配置

在这里插入图片描述
启动 Claude Code 后执行 /status 命令,若显示模型为 deepseek-v4-pro[1m] 则表示配置成功。

首次启动时会有初始化设置:

  • 选择颜色主题(以后可用 /theme 改)
  • 安全提示(仔细读,这是保护你代码的)
  • 确认当前目录是否可信(选「是」)

5.8 常见安装问题解决

问题 1:Windows 提示"bash 不是内部命令"

解决方案:重新安装 Git for Windows,安装时务必选择"Use Git from the command line"

问题 2:环境变量设置了但没生效

解决方案

  • Windows:使用 setx 设置,设置后必须重启终端
  • macOS/Linux:写入 ~/.zshrc~/.bashrc 后执行 source ~/.zshrc
问题 3:返回 401 Unauthorized

解决方案:检查 CC-Switch 里的 API Key 格式,确保目标平台支持 Bearer Token 认证。

保存后重启 Claude Code 即可。


6. 鸿蒙开发相关Skill介绍

6.1 harmony-next

简介

harmony-next是为AI编程助手(如Gemini CLI、Claude Code、Codex)设计的参考技能库。它为HarmonyOS NEXT(以API 12+为主)提供本地化的离线知识源,包含4,257份涵盖ArkTS、ArkUI和NDK的Markdown格式参考文档。

主要特性
  • 全面的API覆盖:包含4,232份JsEtsAPIReference文档
  • 版本标注:文档大量包含API 12-23的版本标注、兼容性说明和变更说明
  • 离线访问:所有文档本地存储,无需网络连接
  • 快速检索:支持按Kit、任务、索引等多种方式渐进式定位文档
适用场景
  • API查询:快速查找HarmonyOS API的使用方法和参数说明
  • 版本兼容:了解不同API版本的兼容性和变更情况
  • 代码示例:获取官方提供的代码示例和最佳实践
  • 学习参考:作为HarmonyOS开发的权威参考资料
知识库结构
harmony-next.skills/
├── JsEtsAPIReference/          # ArkTS API参考文档(4,232份)
├── ApplicationKit/             # 应用开发相关文档
├── ArkUI/                      # UI框架文档
├── NDK/                        # 原生开发文档
└── 其他技术文档...

6.2 arkts-syntax-assistant

简介

arkts-syntax-assistant是ArkTS语言学习和开发助手,专注于ArkTS语法、迁移和优化指导。它为开发者提供从TypeScript到ArkTS的迁移支持,以及ArkTS特有的语法特性和最佳实践。

主要特性
  • 语法检查:实时检查ArkTS语法错误,提供详细的错误信息和修复建议
  • 迁移指导:帮助开发者将TypeScript代码迁移到ArkTS
  • 性能优化:提供ArkTS性能优化建议,如状态管理、组件优化等
  • 编译错误解决:针对ArkTS编译错误提供解决方案
适用场景
  • 语法学习:学习ArkTS特有的语法特性和使用规范
  • 代码迁移:将现有TypeScript代码迁移到ArkTS
  • 错误修复:快速定位和修复ArkTS编译错误
  • 性能调优:优化ArkTS代码的性能表现
触发条件

arkts-syntax-assistant在以下情况下自动触发:

  • 处理.ets文件时
  • 涉及ArkTS关键字的问题
  • TypeScript迁移相关问题
  • 状态管理、组件开发等问题

6.3 本地手动安装skill

通过上述链接下载skill后,不经过包管理体系,直接把 Skill 文件夹复制到本地目录。

# macOS/Linux:复制到用户范围(所有项目可用)
cp -r <skill-folder> ~/.claude/skills/

# macOS/Linux:复制到项目范围(仅当前项目)
cp -r <skill-folder> ./.claude/skills/

# Windows PowerShell(用户范围)
Copy-Item -Recurse ".\skill-folder" "$env:USERPROFILE\.claude\skills\"
# 安装完成后,重启 Claude Code,

通过 /skills命令验证是否安装成功

在这里插入图片描述

7. 鸿蒙开发相关MCP介绍

7.1 deveco-mcp

简介

DevEco Toolbox是一个工具集(依赖于DevEco Studio),可以在不打开DevEco Studio的情况下,在Trae、Cursor、Visual Studio Code等AI IDE中完成鸿蒙应用开发的大多数工作。DevEco Toolbox当前包含两个可执行文件:

  • deveco-toolbox:用于可视化配置
  • deveco-mcp-server:主要的MCP服务
主要功能
  1. 项目管理

    • 创建新项目
    • 配置项目属性
    • 管理依赖包
  2. 构建部署

    • 编译项目
    • 生成HAP包
    • 安装到设备
    • 启动应用
  3. 设备交互

    • 获取设备列表
    • 启动应用
    • 获取UI树
    • 执行UI操作(点击、滑动、输入等)
    • 截图
    • 获取日志
  4. 开发辅助

    • 搜索HarmonyOS文档
    • 检查ETS文件语法
    • 获取设备日志
    • 获取崩溃日志
MCP工具列表
  1. mcp_deveco-mcp_build_project

    • 功能:执行编译构建导出构建产物
    • 参数:
      • build_intent:构建意图(LogVerification、Release等)
      • module:指定的模块及Target
      • product:指定的Product名称
  2. mcp_deveco-mcp_start_app

    • 功能:在模拟器/真机上运行应用
    • 参数:
      • ability:Ability名称(默认EntryAbility)
      • module:模块名称(默认entry)
      • target:构建目标(默认default)
      • hvd:目标设备名称或ID
  3. mcp_deveco-mcp_get_app_ui_tree

    • 功能:获取UI信息并保存为JSON文件
    • 参数:
      • mode:dump模式(simple-窗口节点信息,full-完整UI树)
      • outputDirectory:保存JSON文件的目录绝对路径
      • hvd:目标设备名称
  4. mcp_deveco-mcp_perform_ui_action

    • 功能:统一的UI操作工具
    • 支持的操作类型:
      • click:单击
      • directionalFling:方向滑动
      • inputText:输入文本
      • keyEvent:按键事件
      • screenshot:截图
  5. mcp_deveco-mcp_get_hilog_or_faultlog_recent

    • 功能:获取模拟器/真机设备的hilog/faultlog日志
    • 参数:
      • bundle_name:应用包名
      • domain:日志领域
      • level:日志级别(D、I、W、E、F)
      • tag:过滤标签
      • keyword:关键字过滤
      • is_crash_log:是否获取崩溃日志
  6. mcp_deveco-mcp_harmonyos_knowledge_search

    • 功能:搜索HarmonyOS开发文档
    • 参数:
      • keywords:搜索关键词列表
      • maxCharSize:最大返回字符数(默认5000)
  7. mcp_deveco-mcp_check_ets_files

    • 功能:对传入的ets文件进行静态语法检查
    • 参数:
      • files:待检查的ETS文件路径列表

7.2 安装方式

项目更新活跃建议,直接点击项目链接查看安装方法。

8. 总结

通过 DeepSeek V4 + Claude Code + CC-Switch 这套组合,鸿蒙应用开发者可以获得:

极致性价比:得益于 DeepSeek V4 极高的缓存命中率,日常重度使用月费可轻松控制在百元以内。相比官方 Claude Opus,成本大大节省,却依然保持接近 Opus 4.6 的交付质量。

百万上下文成为标配:1M token 的超长上下文能轻松容纳整个项目代码库,跨文件重构、全库分析再也不用受上下文限制。

完全可控的工具链:CC-Switch 让模型切换、配置同步、健康检查全部可视化,模型不满意随时换,框架升级由你决定,所有数据留在本地,真正做到“生产资料在自己手里”。

领域知识增强:鸿蒙专用 Skill 覆盖语法、API、支付,让 AI 编码更精准。

行动能力延伸:通过 DevEco MCP Server,AI 可直接编译构建、检查语法、部署应用,实现“知识 + 行动”闭环。

这套方案的核心优势就两个字:自由——不再被昂贵的订阅费绑架,不再被封闭的生态锁定,用极低的成本,享受顶级的 AI 编程体验。

参考资源


Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐