Claude Code 从 0 配置
前言
- 下面以 Windows 为例,使用自定义模型的 API Key;如果你使用的是 Claude Code 官方模型,则不要参考下面的配置
- 本文会带你从零开始,完成 Node.js 与 Claude Code 的安装、模型 API 的接入,以及权限的配置
安装 Claude Code
安装 NodeJs
也有其他方式安装的,但是推荐这种方式,因为后面安装其他扩展时,比较嵌合
下载完成后,双击安装
安装完成后,使用
windows + r打开运行框,输入cmd打开命令行输入
node -v查看版本,输入npm -v查看 npm 版本先全局安装
nrm用于切换国内镜像源,npm i -g nrmnrm ls查看所有镜像源nrm use taobao切换到淘宝镜像源
安装 Claude Code
sh
npm i -g @anthropic-ai/claude-code
# 查看版本, 如果显示版本号, 则安装成功
claude -v打开 Claude Code 配置文件
- 一般配置可以使用
claude /config配置,这里直接修改配置文件 - 一般地址为:
C:\Users\Administrator\.claude\settings.json - 配置自己的大模型 API Key
json
{
"env": {
"ANTHROPIC_BASE_URL": "你的平台 api 地址",
"ANTHROPIC_AUTH_TOKEN": "你的 api key",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的平台的模型",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "你的平台的模型",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "你的平台的模型"
},
"permissions": {
"defaultMode": "acceptEdits"
},
"enabledPlugins": {
"context7@claude-plugins-official": true,
"frontend-design@claude-plugins-official": true,
"superpowers@claude-plugins-official": true,
"code-simplifier@claude-plugins-official": true,
"claude-mem@thedotmack": true
},
"language": "Chinese",
"theme": "dark-daltonized",
"skipDangerousModePermissionPrompt": true
}配置解释
ANTHROPIC_BASE_URL: API 请求的基础地址ANTHROPIC_AUTH_TOKEN: API 认证 Token(部分平台也支持使用ANTHROPIC_API_KEY以x-api-key方式认证)CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 关闭所有非核心上报、后台网络流量CLAUDE_CODE_ATTRIBUTION_HEADER: 移除 API 请求里 x-anthropic-billing-header 计费归属请求头CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 清除所有 Anthropic 私有实验 Beta 标识acceptEdits: Claude 生成文件修改代码时,自动应用编辑,不弹窗确认language: 对话语言theme: 主题skipDangerousModePermissionPrompt: 跳过危险模式权限提示(claude --skip-dangerous-mode-permission-prompt)
模型档位映射
- Claude Code 内部会把模型分成三个档位来调用,使用第三方 API 时,需要把这三个档位分别映射到你平台对应的模型:
ANTHROPIC_DEFAULT_OPUS_MODEL: 最强档位,用于复杂推理、代码生成等重任务ANTHROPIC_DEFAULT_SONNET_MODEL: 均衡档位,默认的主力模型ANTHROPIC_DEFAULT_HAIKU_MODEL: 最快档位,用于简单、快速、低成本的任务
- 如果你的平台只有单一模型,可以把这三个变量都填成同一个模型名
enabledPlugins 插件
- 这里可以配置你想要使用的插件,上面配置的插件,如果你不需要的话,可以删除
context7@claude-plugins-official: 实时拉取第三方库最新官方文档,根治 API 幻觉frontend-design@claude-plugins-official: 生成高质量、工业级 UI 页面,消除廉价 AI 套皮样式superpowers@claude-plugins-official: 给 Claude 完整标准化工程开发工作流,像资深工程师一样规范编码code-simplifier@claude-plugins-official: 无损重构简化代码,清理 AI 生成冗余代码claude-mem@thedotmack: 跨会话持久长期记忆,解决关闭对话就失忆的问题
插件安装方式
- claude-mem@thedotmack 插件安装方式
- 官方插件安装方式
sh
claude /plugins第三方平台配置示例
- 下面以 DeepSeek 官方 API 为例,其他平台类似,只需要替换
ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN和三个模型名即可
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner"
}
}deepseek-chat: 通用对话模型(对应 V3 系列)deepseek-reasoner: 深度推理模型(对应 R1 系列)
配置 Claude Code 权限
- 配置文件地址:
C:\Users\Administrator\.claude\settings.local.json
json
{
"permissions": {
"allow": ["Read", "Write", "Edit", "Delete", "Bash(*)"],
"deny": ["Bash(git *)"]
}
}- 文件全权限:可读、写、改、删项目任意文件
- Shell 全局放行:绝大多数终端命令都能自动运行
- 锁死 git(为了防止 AI 清理 git 记录,回退版本):AI 不能自动提交、推送、切换分支等版本库操作,所有 git 操作必须你手动输入
- 通配符
*表示匹配任意内容,Bash(*)表示放行所有 shell 命令,Bash(git *)表示禁止所有 git 命令 - 当
allow与deny同时匹配时,deny优先级更高 - 以上就是 Claude Code 的权限配置
启动与验证
- 在任意项目目录下输入
claude即可启动
sh
# 启动 Claude Code
claude
# 查看当前版本
claude -v
# 查看当前状态(模型、配置等)
claude /status
# 切换模型
claude /model总结
- 通过以上步骤,你就完成了 Claude Code 在 Windows 上的从零安装与配置,可以开始使用自定义模型的 API 了
- 配置的核心在于两点:接入模型 API(
ANTHROPIC_BASE_URL+ANTHROPIC_AUTH_TOKEN),以及映射三个模型档位(ANTHROPIC_DEFAULT_*_MODEL) - 如果后续遇到问题,可以先检查环境变量是否配置正确,以及模型名是否与平台一致