claude code 国内安装使用

一、claude code 安装

官网地址：https://code.claude.com/docs/en/quickstart

windows 安装命令

# powershell 方式
irm https://claude.ai/install.ps1 | iex

# cmd 方式
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

以上两种方式，由于claude方面的限制，都安装失败了，使用winGet安装方式，最简单

winget install Anthropic.ClaudeCode

安装完成，查看版本

claude --version

二、去掉登录限制

让claude，跳过登录限制。cmd 执行一下命令

echo {"hasCompletedOnboarding":true} > %USERPROFILE%\.claude.json
echo {"primaryApiKey":"dummy"} > %USERPROFILE%\.claude\config.json

这样以后claude code认为已经登录过了，不再弹出login

三、安装 cc Switch

下载地址：https://github.com/farion1231/cc-switch

cc switch 是什么：是一款专为 Claude Code 打造的跨平台模型 / 供应商一键切换工具，本质是 AI 编程工具的配置中心 + 切换管家，解决多模型、多 API、多账号来回改配置的痛点，在 Claude Code 里秒切 Claude、GLM、DeepSeek、Kimi、Gemini 等任意大模型，不用手动改 JSON、不用重启、不怕格式报错。

安装成功后，界面如下：

添加模型

如下，我这里选择的deepseek

需要注意的是请求地址和api格式

DeepSeek 模型要在 Claude Code 里使用，必须通过兼容 Anthropic 协议的中转网关，而不是直接连官方 DeepSeek 地址，所以请求地址和api格式需要选择填写：

# 请求地址
https://api.deepseek.com/anthropic

# api格式
Anthropic Messages

为什么要选 Anthropic Messages？

Claude Code 是为 Anthropic 协议设计的，它只会用 /v1/messages 接口格式发请求。

• 选 OpenAI Chat Completions：Claude Code 会把请求发到 /chat/completions，但 DeepSeek 官方的这个接口和 Claude Code 不兼容，所以你才会遇到「找不到模型」的报错。
• 选 Anthropic Messages：Claude Code 会用它原生的格式发请求，DeepSeek 官方提供了兼容 Anthropic 协议的接口，刚好可以完美适配 Claude Code。

配置完成后json示例如下：

{
  "name": "DeepSeek-Claude",
  "base_url": "https://api.deepseek.com/anthropic",
  "api_key": "sk-你的密钥",
  "api_mode": "anthropic_messages",
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "deepseek-v4-pro",
      "context_length": 128000
    }
  ]
}

cc switch中启动模型

四、启动claude code

重启命令行窗口，启动 claude code

claude

如果发现进入claude code 后显示 not login，或者提示没有选择模型。

直连deepseek，不走cc switch

重启命令行窗口，执行一下命令（临时生效）；通过这种方式可。

# 替换成你的中转地址
set ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
# 替换成你的 API Key
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxx

或者（永久生效）

setx ANTHROPIC_BASE_URL "https://api.deepseek.com/anthropic"
setx ANTHROPIC_AUTH_TOKEN "sk-你的DeepSeek密钥"

走cc switch方式

在claude 命令行标签页新建一个deepseek的供应商

cc switch 开启路由模式

设置关键变量

$env:CLAUDE_CODE_API_BASE_URL = "http://127.0.0.1:15721"
$env:CLAUDE_CODE_API_KEY = "你CC-Switch里的全局API Key"

重启claude 

五、claude code 图形界面免登录配置

1、安装 claude code 桌面端

打开客户端，在登录界面不要点登录，直接：

• 顶部菜单 → Help → Troubleshooting → Enable Developer Mode
• 按提示重启客户端

重启后，顶部菜单会出现 Developer → Configure Third-Party Inference…

• 进入后，选择 Gateway 或 Custom 模式
• 填入第三方模型的 API 地址、Key、模型名（比如 DeepSeek）

启动cc Switch，进入设置，开启本地路由

api地址要填写 cc Switch 的 服务地址：http://127.0.0.1:15721，配置好后重启claude code 即可使用专属的 deepseek 模型了。