Claude Code桌面版安装与使用

[Claude Code安装](#Claude Code安装)
[Claude Code使用](#Claude Code使用)
接入国内大模型API

Claude Code安装

🤖 桌面版下载地址：https://claude.com/download

通过官方脚本安装：

bash 复制代码

# macOS or Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

通过npm安装（需要node.js环境）：

bash 复制代码

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

验证版本：

bash 复制代码

claude --version

Claude Code使用

安装完成后，进入你的项目路径下启动Claude Code：

bash 复制代码

cd /path/myproject
claude

以下是常用命令：

bash 复制代码

/login   #登录Claude账户
/help    #显示可用命令
/model   #查看支持的模型
/clear   #清除对话历史
/compact #总结后清除对话历史
/cost    #显示对话时长和计费
/resume  #恢复之前的对话
/exit    #退出

第一次登录Claude Code需要有官方订阅账号。我们可以通过修改Claude的配置文件来规避。

在.claude/config.json文件中添加或修改以下参数：

json 复制代码

{
  "primaryApiKey": "any-string-is-ok-here"
}

这个字段仅用于通过插件的本地状态校验，内容可以随意填写。

在.claude.json文件中添加或修改以下参数：

json 复制代码

{
  "hasCompletedOnboarding": true
}

配置文件位置：

Windows系统中：
- C:\Users\用户名\.claude\config.json
- C:\Users\用户名\.claude.json
macOS系统中：
- /.claude/config.json
- /.claude/.claude.json

接入国内大模型API

以DeepSeek为例，需要在终端中设置环境变量。

Linux环境：

bash 复制代码

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=${DEEPSEEK_API_KEY}   # 这里设置你申请的API key
export API_TIMEOUT_MS=600000
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

macOS环境：

zsh 复制代码

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"' >> ~/.zshrc
echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc 
echo 'export ANTHROPIC_MODEL=deepseek-chat' >> ~/.zshrc 
echo 'export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat' >> ~/.zshrc 
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc 

source ~/.zshrc

验证是否生效：

zsh 复制代码

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Windows PowerShell环境：

powershell 复制代码

# 设置你的DeepSeek API Key（必须先设置！）
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "your_api_key_here", "User")

# 设置其他变量（引用上面的DEEPSEEK_API_KEY）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [Environment]::GetEnvironmentVariable("DEEPSEEK_API_KEY", "User"), "User")
[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "600000", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-chat", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "deepseek-chat", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

验证是否生效：

powershell 复制代码

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

以指定模型启动：

bash 复制代码

claude --model deepseek-chat

或者启动后切换模型：

bash 复制代码

/model deepseek-chat

References

【1】https://code.claude.com/docs/en/overview

【2】https://code.claude.com/docs/zh-CN/settings

【3】https://www.runoob.com/claude-code/claude-code-hooks.html

【4】https://api-docs.deepseek.com/zh-cn/guides/anthropic_api

【5】CC Switch项目地址，https://github.com/farion1231/cc-switch/

【6】国内免费使用Claude Code无需登录，https://mp.weixin.qq.com/s/LeitH9v_4onFQpTuI23Xsw

【7】CC Swicth管理API配置，https://mp.weixin.qq.com/s/pa9Gpim7jVXsUtEM8JwnSg

【8】Claude code+GLM 4.6保姆级配置教程，https://zhuanlan.zhihu.com/p/1957370685748938170

【9】Claude Code跳过强制登录解决方法，https://blog.csdn.net/qq_51335325/article/details/157253081