Claude Code 桌面端下载安装 + 国内 AI 接口配置完全指南
Claude Code 是 Anthropic 公司推出的 AI 编程助手,可以集成到命令行或 VS Code 中使用。本文详细介绍桌面端的下载安装步骤,并教你如何配置国内 AI 接口(如 DeepSeek、Qwen 等)。
一、安装 Claude Code 桌面端
方法一:Native 安装(推荐)
在 Windows PowerShell 中运行:
# 安装
irm https://claude.ai/install.ps1 | iex
卸载命令:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
方法二:WinGet 安装
# 安装
winget install Anthropic.ClaudeCode
# 更新
winget upgrade Anthropic.ClaudeCode
# 卸载
winget uninstall Anthropic.ClaudeCode
启动使用
安装完成后,在项目文件夹打开命令行,输入 claude 即可启动。
二、解决地域限制
如果出现 "Anthropic 不能在您所在的地区使用" 的提示,按以下步骤解决:
- 打开目录
C:\Users\[您的用户名] - 找到或创建
.claude.json文件 - 在最后一个
}之前添加:
"hasCompletedOnboarding": true
三、配置国内 AI 模型接口
Claude Code 默认使用 Anthropic 的模型,需要通过 cc-switch 切换到国内模型。
3.1 安装 cc-switch
cc-switch 是一个管理和切换 Claude Code 后端模型的跨平台图形化桌面应用。
官网:https://github.com/farion1231/cc-switch
下载对应版本:
- Windows:
CC-Switch-v3.10.3-Windows-Portable.zip或.msi
3.2 添加模型供应商
方式一:使用魔搭社区(每日 2000 次免费额度)
- 访问 https://modelscope.cn/
- 进入 "访问控制",绑定阿里云账号
- 创建访问令牌(API Key)
方式二:使用 DeepSeek
- 访问 https://platform.deepseek.com/
- 注册账号并获取 API Key
方式三:使用 MINIMAX
- 访问 https://platform.minimaxi.com/
- 创建 API Key
3.3 在 cc-switch 中配置
打开 cc-switch,选择预设供应商(如魔搭社区),填写:
| 配置项 | 说明 |
|---|---|
| API Key | 填入上面获取的密钥 |
| 模型名称 | 参考下方模型选择 |
3.4 推荐模型选择
| 模型版本 | 速度 | 成本 | 智力水平 | 最佳应用场景 |
|---|---|---|---|---|
| Haiku | 极快 ⚡️ | 最低 💰 | 入门级 | 客服、翻译、简单数据清洗 |
| Sonnet | 快 🚀 | 中等 💰💰 | 高级 | 编程、日常办公(性价比之王) |
| Opus | 较慢 🐢 | 最高 💰💰💰 | 顶级 🧠 | 创意写作、复杂策略、深度分析 |
| Opus Thinking | 最慢 ⏳ | 极高 💎 | 超越极限 | 数学证明、算法竞赛、硬核推理 |
3.5 常用模型名称
编程模型:
- Qwen/Qwen3-Coder-480B-A35B-Instruct
- Qwen/Qwen2.5-Coder-32B-Instruct
推理模型:
- Qwen/Qwen3-235B-A22B-Thinking-2507
- DeepSeek-V3
四、基础使用技巧
初始化项目
claude
/init
Claude Code 会通读项目并生成 CLAUDE.md 文件。
压缩对话记录
减少 Token 消耗:
/compact
清除对话记录
/clear
切换模式
Alt+m:普通模式 / auto accept 模式 / plan mode
调整思考强度
在对话前加提示词控制思考长度:
think- 标准思考think hard- 深度思考think harder- 更深度思考ultrathink- 极限思考
临时命令行模式
输入 ! 后接命令,比如:
!git status
连接 VS Code
安装插件后,输入 /ide 连接。
五、可视化界面(可选)
Claude Code 默认是命令行工具,如需图形界面可使用:
- opcode:https://github.com/winfunc/opcode(macOS/Linux)
- Claudia-global:https://github.com/who10086/claudia-global(Windows)
总结
- 安装 :推荐使用 Native 安装方式
- 解决限制 :修改
.claude.json添加hasCompletedOnboarding: true - 国内模型 :通过 cc-switch 配置魔搭社区 /DeepSeek 等供应商
- 免费额度 :魔搭社区每日 2000 次免费额度
这样就可以在国内网络环境下免费使用 Claude Code 了!
参考资料:Claude Code 官方文档、博客园、GitHub
正文完