Claude Code从安装到国内模型配置(含DS/CC-Switch)

作为Anthropic推出的终端原生AI编程助手,Claude Code以极强的代码理解和项目重构能力,正在成为开发者的效率神器。但对国内用户来说,官方安装与模型配置的坑点不少。本文将带你从零开始,完成「安装→配置国内模型→多模型切换」的完整流程,并解决你遇到的所有常见问题。


一、安装 Claude Code:两种方案任选

方案 1:原生安装脚本(推荐,无需 Node.js)

这是官方推荐的方式,无Node依赖,更新更稳定。

bash 复制代码
curl -fsSL https://claude.ai/install.sh | bash

方案 2:Node.js 全局安装(适合已有Node环境)

如果没有安装,可以参考OpenCode安装及配置Claude Opus 4.6模型

如果你的电脑已经安装了 Node.js(v18+),可以用npm快速安装:

bash 复制代码
# 先配置 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

验证安装

打开新终端,执行以下命令,输出版本号即成功:

bash 复制代码
claude --version

此时使用会无法连接Anthropic,需要科学,并且官方对地区封号力度大,本篇配置国内模型。

如果没有安装过git,需要按照提示先安装git。

修改配置

首先到C盘个人目录下,我的是C:\Users\ASUS,找到下图文件,进行修改配置。

然后修改.claude.json文件

新增hasCompletedOnboarding参数

bash 复制代码
 {
   "hasCompletedOnboarding": true
 }

此时使用claude就能跳过登录了。

回车即可。

二、安装CC-switch

github链接:cc-switch

根据自己电脑选择安装包,这里我选择的是CC-Switch-3.14.0-Windows.msi进行安装,然后双击安装包,选择合适位置进行安装即可。

三、接入国内模型(以DeepSeek为例)

1. 前置准备:获取 DeepSeek API Key

  1. 访问 DeepSeek 开放平台 注册登录
  2. 进入「API 密钥」页面,创建新密钥并复制(格式为sk-xxxx)

2. 配置方式 1:环境变量配置(临时生效)

适合快速测试,重启终端后失效。

  • Windows (PowerShell)
bash 复制代码
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com"
$env:ANTHROPIC_API_KEY = "你的DeepSeek API Key"
$env:ANTHROPIC_MODEL = "DeepSeeK-V3.2"
  • macOS / Linux
bash 复制代码
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export ANTHROPIC_API_KEY="你的DeepSeek API Key"
export ANTHROPIC_MODEL="DeepSeeK-V3.2"

3. 配置方式 2:永久配置(推荐)

将配置写入 Claude Code 设置文件,重启终端也生效。

  1. 打开配置文件(Windows 路径):C:\Users\你的用户名\.claude\settings.json

  2. 写入以下内容:

    bash 复制代码
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com",
        "ANTHROPIC_API_KEY": "你的DeepSeek API Key",
        "ANTHROPIC_MODEL": "DeepSeeK-V3.2",
        "ANTHROPIC_SMALL_FAST_MODEL": "DeepSeeK-V3.2",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeeK-V3.2",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeeK-V3.2",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeeK-V3.2"
      }
    }

4.CC-switch配置

打开CC-switch,供应厂商选deepseek,然后填写之前创建的api-key。

随后点击添加即可。

5. 测试配置

在终端输入claude启动工具,输入hello测试。如果正常回复,说明配置成功。

四、claude常用命令

1.基础核心命令

bash 复制代码
# 启动 Claude
claude

# 查看版本
claude --version

# 查看帮助
claude --help

# 退出 Claude
/exit

2.模型与配置命令

bash 复制代码
# 查看当前使用的模型
/model

# 切换模型(解决 Model Not Exist)
/model deepseek-chat
/model deepseek-reasoner

# 查看当前所有配置信息
/info

3.对话管理命令

bash 复制代码
# 清空上下文(解决回答错乱)
/clear

# 查看历史对话
/history

# 撤销上一轮对话
/undo

# 保存当前对话到文件
/save 对话名称.md

4.项目管理最强命令

bash 复制代码
# 初始化项目(生成 CLAUDE.md,让 AI 理解整个项目)
/init

# 查看当前项目结构
/tree

# 让 AI 忽略某些文件(如 node_modules)
/ignore node_modules

5.文件操作命令(直接让 AI 读写代码)

bash 复制代码
# 读取文件内容
/read 文件名.js
/read src/App.vue

# 写入/覆盖文件
/write 文件名.js

# 编辑文件
/edit 文件名.js

# 搜索文件内容
/search 关键词

6.任务执行命令

bash 复制代码
# 执行终端命令
!npm install
!git status

# 重做上一个任务
/redo

# 停止当前任务
/stop

7.调试与日志

bash 复制代码
# 查看错误详情
/debug

# 查看当前 API 配置是否正确
/env

8.常用使用流程

  1. 进入你的项目文件夹

  2. 输入 claude 启动

  3. 输入 /init 让AI认识项目

  4. 输入 /model 确保模型正确

  5. 直接说需求:

    • 帮我写登录接口
    • 帮我检查 bug
    • 帮我优化代码
    • 帮我生成 README

Claude Code真正的强大之处,在于它能理解整个项目的代码上下文,帮你处理复杂的重构、调试和文档工作。国内用户通过接入国产模型,也能零门槛体验它的高效能力。

相关推荐
最强小杰13 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
Maynor99614 小时前
Trymodel 使用介绍:一个平台同时用 Claude、GPT、Gemini 和 Grok
人工智能·gpt·ai·程序员·教程·claude·语音
七夜zippoe14 小时前
多 Agent 通信灾难:状态不一致导致雪崩故障的排查与防护
ai·agent·通信灾难·雪崩故障·排查与防护
Forget the Dream16 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
zdr尽职尽责18 小时前
UnityCli 兼容2022版本
ui·unity·ai·c#·游戏引擎
ZzT1 天前
约 90% 代码由 Claude 写和审,Claude Code 团队如何做验证
ai编程·claude
Sharewinfo_BJ1 天前
从“看数据”到“做决策”:AI时代,BI的下一个形态是什么?
ai·数据分析·bi·智信bi
codigger1 天前
AI 三分钟写完的代码,你凭什么敢直接上线?
ai·程序员·编程·ai编程·#人工智能
一缕82年的清风1 天前
谷歌甩出 Gemini 4 Neon:Agent 编程榜登顶第一、缓存仅 $0.15,把刚发的 GPT-6.2 架在火上烤!
gpt·claude·gemini
wflynn2 天前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术