Claude Code安装配置及接入国产模型

作为Anthropic推出的终端原生AI编程助手Claude Code以极强的代码理解和项目重构能力正在成为开发者的效率神器。但对国内用户来说官方安装与模型配置的坑点不少。本文将带你从零开始完成「安装→配置国内模型→多模型切换」的完整流程并解决你遇到的所有常见问题。一、安装 Claude Code两种方案任选方案 1原生安装脚本推荐无需 Node.js这是官方推荐的方式无Node依赖更新更稳定。Windows (PowerShell)irm https://claude.ai/install.ps1 | iexmacOS / Linux / WSLcurl -fsSL https://claude.ai/install.sh | bash方案 2Node.js 全局安装适合已有Node环境如果没有安装可以参考OpenCode安装及配置Claude Opus 4.6模型如果你的电脑已经安装了 Node.jsv18可以用npm快速安装# 先配置 npm 全局路径到 mkdir D:\node_global mkdir D:\node_cache npm config set prefix D:\node_global npm config set cache D:\node_cache # 安装 Claude Code npm install -g anthropic-ai/claude-code并把node_global文件路径配置到环境变量中去。验证安装打开新终端执行以下命令输出版本号即成功claude --version此时使用会无法连接Anthropic需要科学并且官方对地区封号力度大本篇配置国内模型。如果没有安装过git需要按照提示先安装git。修改配置首先到C盘个人目录下我的是C:\Users\ASUS找到下图文件进行修改配置。然后修改.claude.json文件新增hasCompletedOnboarding参数{ hasCompletedOnboarding: true }此时使用claude就能跳过登录了。回车即可。二、安装CC-switchgithub链接cc-switch根据自己电脑选择安装包这里我选择的是CC-Switch-3.14.0-Windows.msi进行安装然后双击安装包选择合适位置进行安装即可。三、接入国内模型以DeepSeek为例1. 前置准备获取 DeepSeek API Key访问 DeepSeek 开放平台 注册登录进入「API 密钥」页面创建新密钥并复制格式为sk-xxxx2. 配置方式 1环境变量配置临时生效适合快速测试重启终端后失效。Windows (PowerShell)$env:ANTHROPIC_BASE_URL https://api.deepseek.com $env:ANTHROPIC_API_KEY 你的DeepSeek API Key $env:ANTHROPIC_MODEL DeepSeeK-V4 PromacOS / Linuxexport ANTHROPIC_BASE_URLhttps://api.deepseek.com export ANTHROPIC_API_KEY你的DeepSeek API Key export ANTHROPIC_MODELDeepSeeK-V4 Pro3. 配置方式 2永久配置推荐将配置写入 Claude Code 设置文件重启终端也生效。打开配置文件Windows 路径C:\Users\你的用户名\.claude\settings.json写入以下内容{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com, ANTHROPIC_API_KEY: 你的DeepSeek API Key, ANTHROPIC_MODEL: DeepSeeK-V4 Pro, ANTHROPIC_SMALL_FAST_MODEL: DeepSeeK-V4 Pro, ANTHROPIC_DEFAULT_SONNET_MODEL: DeepSeeK-V4 Pro, ANTHROPIC_DEFAULT_OPUS_MODEL: DeepSeeK-V4 Pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: DeepSeeK-V4 Pro } }4.CC-switch配置打开CC-switch供应厂商选deepseek然后填写之前创建的api-key。随后点击添加即可。5. 测试配置在终端输入claude启动工具输入hello测试。如果正常回复说明配置成功。四、claude常用命令1.基础核心命令# 启动 Claude claude # 查看版本 claude --version # 查看帮助 claude --help # 退出 Claude /exit2.模型与配置命令# 查看当前使用的模型 /model # 切换模型解决 Model Not Exist /model deepseek-chat /model deepseek-reasoner # 查看当前所有配置信息 /info3.对话管理命令# 清空上下文解决回答错乱 /clear # 查看历史对话 /history # 撤销上一轮对话 /undo # 保存当前对话到文件 /save 对话名称.md4.项目管理最强命令# 初始化项目生成 CLAUDE.md让 AI 理解整个项目 /init # 查看当前项目结构 /tree # 让 AI 忽略某些文件如 node_modules /ignore node_modules5.文件操作命令直接让 AI 读写代码# 读取文件内容 /read 文件名.js /read src/App.vue # 写入/覆盖文件 /write 文件名.js # 编辑文件 /edit 文件名.js # 搜索文件内容 /search 关键词6.任务执行命令# 执行终端命令 !npm install !git status # 重做上一个任务 /redo # 停止当前任务 /stop7.调试与日志# 查看错误详情 /debug # 查看当前 API 配置是否正确 /env8.常用使用流程进入你的项目文件夹输入claude启动输入/init让AI认识项目配置规则输入/model确保模型正确直接说需求帮我写登录接口帮我检查 bug帮我优化代码帮我生成 READMEClaude Code真正的强大之处在于它能理解整个项目的代码上下文帮你处理复杂的重构、调试和文档工作。国内用户通过接入国产模型也能零门槛体验它的高效能力。实用小技巧(更新中...)1.让你的Agent能够操作本机电脑的浏览器如搜索、测试等跳过Agent自身的搜索工具国内网站存在政策限制解锁ClaudeCode浏览器访问-Playwright Clihttps://blog.csdn.net/2401_87660168/article/details/1614907812.让你的Agent能够拉取提交代码创建分支等能够了解历史改动不犯相同的错误GitHub CLI让你的CC自动提交代码https://blog.csdn.net/2401_87660168/article/details/161522099。。。。。。