目录什么是 Claude Code系统要求与准备工作安装 Node.js安装 Claude Code获取 API Key基础配置环境变量与 settings.json第三方模型配置国内用户必看CC Switch 可视化工具配置VS Code / JetBrains IDE 集成常见模型 API 配置速查表常见问题排查参考资料1. 什么是 Claude CodeClaude Code 是 Anthropic 推出的官方 AI 编程工具以命令行CLI形式运行可以直接在终端中与 Claude 对话实现代码编写、调试、重构、文档生成等功能。核心特性直接读取和编辑本地项目文件执行终端命令并分析结果支持 Git 操作可集成到 VS Code / JetBrains 等主流 IDE支持通过第三方 API 接入国产大模型DeepSeek、GLM、Qwen 等2. 系统要求与准备工作项目要求操作系统Windows 10/11、macOS 12、Ubuntu 20.04Node.js 18.0推荐 20.x LTSnpm 9.0随 Node.js 一起安装内存 4GB RAM网络需要能访问 npm 仓库和 API 端点磁盘空间 500MB2.1 检查已有环境# 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v3. 安装 Node.js3.1 Windows方式一官网安装包推荐访问 Node.js — Run JavaScript Everywhere下载LTS长期支持版安装包双击运行安装程序一路默认即可方式二使用 nvm-windows版本管理# 安装 nvm-windows 后 nvm install 20 nvm use 203.2 macOS# 使用 Homebrew brew install node20 # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash nvm install 20 nvm use 203.3 Linux (Ubuntu/Debian)# 使用 NodeSource curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc nvm install 203.4 验证安装node -v # 应输出 v20.x.x npm -v # 应输出 10.x.x4. 安装 Claude Code4.1 官方安装海外用户npm install -g anthropic-ai/claude-code4.2 国内安装使用淘宝镜像加速国内直接安装可能因网络问题导致失败建议先切换 npm 镜像源# 设置淘宝镜像 npm config set registry https://registry.npmmirror.com # 验证镜像设置成功 npm config get registry # 安装 Claude Code npm install -g anthropic-ai/claude-code这样算是安装成功了4.3 验证安装claude --version如果输出版本号如1.x.x说明安装成功。4.4 更新 Claude Codenpm update -g anthropic-ai/claude-code4.5 国内用户更新镜像源npm config set registry https://registry.npmmirror.com npm update -g anthropic-ai/claude-code5. 获取 API Key5.1 Anthropic 官方 API Key5.2 第三方中转 API Key国内推荐国内用户推荐使用第三方 API 中转服务无需海外信用卡且支持国产模型服务商说明OpenRouter支持多种模型国际通用硅基流动支持 DeepSeek、GLM 等国产模型火山引擎字节跳动旗下支持豆包等模型阿里云百炼支持通义千问系列CloseAIAnthropic 协议兼容中转其他中转站根据个人需求选择 第三方 API Key 格式通常为sk-开头。6. 基础配置环境变量与 settings.jsonClaude Code 的配置有两种方式终端环境变量临时和settings.json 文件持久化。6.1 方式一终端环境变量临时Windows CMDsetx ANTHROPIC_API_KEY sk-ant-你的密钥 setx ANTHROPIC_BASE_URL https://你的中转地址Windows PowerShell$env:ANTHROPIC_API_KEY sk-ant-你的密钥 $env:ANTHROPIC_BASE_URL https://你的中转地址macOS / Linuxexport ANTHROPIC_API_KEYsk-ant-你的密钥 export ANTHROPIC_BASE_URLhttps://你的中转地址⚠️ 使用setx设置后需重新打开终端才能生效。 如果只想临时使用在 PowerShell 中用$env:方式设置即可关闭终端后失效。6.2 方式二settings.json推荐持久化Claude Code 的配置文件路径作用域路径说明用户级~/.claude/settings.json对所有项目生效项目级项目目录/.claude/settings.json仅对当前项目生效创建配置文件# 创建配置目录如果不存在 mkdir -p ~/.claude # 使用编辑器打开以 VS Code 为例 code ~/.claude/settings.json基础配置模板官方 API{ env: { ANTHROPIC_API_KEY: sk-ant-你的密钥, ANTHROPIC_BASE_URL: https://api.anthropic.com } }中转 API 配置模板{ env: { ANTHROPIC_BASE_URL: https://你的中转地址.com, ANTHROPIC_AUTH_TOKEN: sk-你的中转密钥 } } 使用中转 API 时密钥变量名可以是ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY二者等效。7. 第三方模型配置国内用户必看Claude Code 支持三种模型接入模式可根据你的 API 提供商选择对应方式。7.1 模式一Anthropic 兼容模式最常用适用于官方 API、模拟 Anthropic 协议的中转站、DeepSeekAnthropic 兼容端点{ env: { ANTHROPIC_BASE_URL: https://api.xxx.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }指定不同模型级别的映射{ env: { ANTHROPIC_BASE_URL: https://api.xxx.com, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-20250514, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-20250514 } }7.2 模式二OpenAI Compatible 模式适用于使用 OpenAI Chat Completions 协议的服务商DeepSeek OpenAI 端点、智谱 GLM、通义千问等{ env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-chat,glm-4-plus,qwen-max, OPENAI_BASE_URL: https://api.deepseek.com/v1, OPENAI_API_KEY: sk-你的密钥 } }⚠️ OpenAI Compatible 模式下Claude Code 的部分内置功能如网络搜索可能不可用。7.3 模式三AWS Bedrock适用于使用 AWS 云服务的用户{ env: { CLAUDE_CODE_USE_BEDROCK: 1, AWS_REGION: us-west-2, AWS_ACCESS_KEY_ID: 你的AK, AWS_SECRET_ACCESS_KEY: 你的SK, ANTHROPIC_MODEL: us.anthropic.claude-sonnet-4-20250514-v1:0 } }7.4 模式四Google Cloud Vertex AI{ env: { CLAUDE_CODE_USE_VERTEX: 1, CLOUD_ML_REGION: us-east5, ANTHROPIC_VERTEX_PROJECT_ID: 你的项目ID, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }8. CC Switch 可视化工具配置CC Switch 是一个专为 Claude Code 打造的开源可视化模型切换工具GitHub 5.9k stars可以免去手动编辑配置文件的麻烦。8.1 CC Switch 简介特性说明零侵入保留 Claude Code 原生使用体验热切换切换模型无需重启多模型支持DeepSeek、GLM、Qwen、Kimi、Claude 等多设备同步支持配置文件云同步本地路由通过 127.0.0.1:15721 实现协议转换8.2 安装 CC Switch# 通过 npm 安装 npm install -g cc-switch # 启动 CC Switch cc-switch当前2026-07-01最新版是CC-Switch-v3.16.5-Windows.msiCC-Switch-v3.16.5-Windows.msi下载链接https://github.com/farion1231/cc-switch/releases/download/v3.16.5/CC-Switch-v3.16.5-Windows.msi8.3 CC Switch 配置步骤启动 CC Switch运行cc-switch或打开桌面应用添加 Provider点击「新增供应商」填入以下信息名称自定义如 DeepSeekBase URLAPI 端点地址API Key你的密钥模型 ID如deepseek-chat选择激活在供应商列表中点击激活启动 Claude Codeclaude即可使用配置的模型8.4 CC Switch 工作原理Claude Code → 127.0.0.1:15721CC Switch 本地路由→ 目标 API 服务商 ↓ 协议转换Anthropic → OpenAI / 其他协议9. VS Code / JetBrains IDE 集成9.1 VS Code 集成打开 VS Code进入扩展市场搜索Claude Code安装官方扩展在 VS Code 终端中运行claude即可9.2 VS Code 中使用第三方模型先按照第 6~8 节配置好环境变量或 settings.json然后在 VS Code 终端中启动 Claude Code 即可自动读取配置。9.3 JetBrains IDE 集成打开 JetBrains IDE如 IntelliJ IDEA、PyCharm进入Settings → Plugins搜索并安装Claude Code插件在内置终端中运行claude10. 常见模型 API 配置速查表10.1 DeepSeekAnthropic 兼容端点 { env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat } } 10.2 DeepSeekOpenAI 兼容端点 { env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-chat, OPENAI_BASE_URL: https://api.deepseek.com/v1, OPENAI_API_KEY: sk-你的DeepSeek密钥 } } 10.3 智谱 GLM / ZLM { env: { CLAUDE_CODE_OPENAI_MODELS: glm-4-plus, OPENAI_BASE_URL: https://open.bigmodel.cn/api/paas/v4, OPENAI_API_KEY: 你的智谱API密钥 } } 10.4 通义千问Qwen { env: { CLAUDE_CODE_OPENAI_MODELS: qwen-max, OPENAI_BASE_URL: https://dashscope.aliyuncs.com/compatible-mode/v1, OPENAI_API_KEY: 你的阿里云API密钥 } } 10.5 KimiMoonshot { env: { CLAUDE_CODE_OPENAI_MODELS: moonshot-v1-128k, OPENAI_BASE_URL: https://api.moonshot.cn/v1, OPENAI_API_KEY: 你的Kimi API密钥 } } 10.6 硅基流动 { env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-v3,glm-4-plus, OPENAI_BASE_URL: https://api.siliconflow.cn/v1, OPENAI_API_KEY: 你的硅基流动密钥 } } 10.7 火山引擎豆包 Seed { env: { CLAUDE_CODE_OPENAI_MODELS: doubao-pro-256k, OPENAI_BASE_URL: https://ark.cn-beijing.volces.com/api/v3, OPENAI_API_KEY: 你的火山引擎密钥 } }11. 常见问题排查11.1 安装问题问题原因解决方案npm install -g报错网络超时国内访问 npm 官方源慢设置淘宝镜像npm config set registry https://registry.npmmirror.comPermission denied权限不足Windows 以管理员运行macOS/Linux 使用sudo npm install -gnode: command not foundNode.js 未安装按照第 3 节安装 Node.jsclaude: command not foundClaude Code 未安装或 PATH 问题重新运行npm install -g anthropic-ai/claude-code11.2 配置问题问题原因解决方案API Key 无效 / 401密钥拼写错误或已过期检查ANTHROPIC_AUTH_TOKEN值确认中转 Key 带sk-前缀Base URL 404URL 格式错误Anthropic 协议 URL 末尾不加/v1OpenAI 协议需加/v1环境变量未生效需要重启终端setx设置后必须新开终端settings.json 修改后重启claude模型权限错误模型未开通在 API 提供商后台开通对应模型的调用权限内置搜索不可用第三方模型限制使用/search off命令关闭搜索功能11.3 使用问题问题原因解决方案响应很慢网络延迟或模型负载检查网络连接尝试切换其他模型中文回答质量差模型选择问题切换到中文优化更好的模型如 GLM-4、Qwen文件读写权限报错目录权限不足确保 Claude Code 运行在项目目录中11.4 查看当前配置# 查看当前环境变量 echo $ANTHROPIC_BASE_URL # macOS/Linux echo %ANTHROPIC_BASE_URL% # Windows CMD echo $env:ANTHROPIC_BASE_URL # Windows PowerShell # 在 Claude Code 会话中查看 claude /config12. 参考资料官方文档Claude Code 官方文档中文Claude Code 模型配置Claude Code 设置API Key 管理社区教程Claude Code 安装配置完整指南 - 知乎Claude Code 国内使用完整教程 - 火山引擎Claude Code 安装教程附适配国内模型 - 腾讯云安装与多模型切换Windows/macOS - ClaudeCNClaude Code 国内安装 2026 最新教程 - 阿里云Claude Code 接入第三方 API - 腾讯云Claude Code API 配置 - 菜鸟教程CC Switch 工具CC Switch GitHub 仓库CC Switch 保姆级教程 - 知乎CC Switch 使用技巧 - 博客园CC Switch 多设备同步 - 火山引擎模型接入DeepSeek V4 接入 Claude Code - CSDNClaude Code CC Switch 配置 - Apifox智谱 Claude API 兼容接口AWS Bedrock 配置指南
ClaudeCode终极配置指南：从安装到多模型集成
发布时间：2026/7/22 19:12:01
目录什么是 Claude Code系统要求与准备工作安装 Node.js安装 Claude Code获取 API Key基础配置环境变量与 settings.json第三方模型配置国内用户必看CC Switch 可视化工具配置VS Code / JetBrains IDE 集成常见模型 API 配置速查表常见问题排查参考资料1. 什么是 Claude CodeClaude Code 是 Anthropic 推出的官方 AI 编程工具以命令行CLI形式运行可以直接在终端中与 Claude 对话实现代码编写、调试、重构、文档生成等功能。核心特性直接读取和编辑本地项目文件执行终端命令并分析结果支持 Git 操作可集成到 VS Code / JetBrains 等主流 IDE支持通过第三方 API 接入国产大模型DeepSeek、GLM、Qwen 等2. 系统要求与准备工作项目要求操作系统Windows 10/11、macOS 12、Ubuntu 20.04Node.js 18.0推荐 20.x LTSnpm 9.0随 Node.js 一起安装内存 4GB RAM网络需要能访问 npm 仓库和 API 端点磁盘空间 500MB2.1 检查已有环境# 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v3. 安装 Node.js3.1 Windows方式一官网安装包推荐访问 Node.js — Run JavaScript Everywhere下载LTS长期支持版安装包双击运行安装程序一路默认即可方式二使用 nvm-windows版本管理# 安装 nvm-windows 后 nvm install 20 nvm use 203.2 macOS# 使用 Homebrew brew install node20 # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash nvm install 20 nvm use 203.3 Linux (Ubuntu/Debian)# 使用 NodeSource curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc nvm install 203.4 验证安装node -v # 应输出 v20.x.x npm -v # 应输出 10.x.x4. 安装 Claude Code4.1 官方安装海外用户npm install -g anthropic-ai/claude-code4.2 国内安装使用淘宝镜像加速国内直接安装可能因网络问题导致失败建议先切换 npm 镜像源# 设置淘宝镜像 npm config set registry https://registry.npmmirror.com # 验证镜像设置成功 npm config get registry # 安装 Claude Code npm install -g anthropic-ai/claude-code这样算是安装成功了4.3 验证安装claude --version如果输出版本号如1.x.x说明安装成功。4.4 更新 Claude Codenpm update -g anthropic-ai/claude-code4.5 国内用户更新镜像源npm config set registry https://registry.npmmirror.com npm update -g anthropic-ai/claude-code5. 获取 API Key5.1 Anthropic 官方 API Key5.2 第三方中转 API Key国内推荐国内用户推荐使用第三方 API 中转服务无需海外信用卡且支持国产模型服务商说明OpenRouter支持多种模型国际通用硅基流动支持 DeepSeek、GLM 等国产模型火山引擎字节跳动旗下支持豆包等模型阿里云百炼支持通义千问系列CloseAIAnthropic 协议兼容中转其他中转站根据个人需求选择 第三方 API Key 格式通常为sk-开头。6. 基础配置环境变量与 settings.jsonClaude Code 的配置有两种方式终端环境变量临时和settings.json 文件持久化。6.1 方式一终端环境变量临时Windows CMDsetx ANTHROPIC_API_KEY sk-ant-你的密钥 setx ANTHROPIC_BASE_URL https://你的中转地址Windows PowerShell$env:ANTHROPIC_API_KEY sk-ant-你的密钥 $env:ANTHROPIC_BASE_URL https://你的中转地址macOS / Linuxexport ANTHROPIC_API_KEYsk-ant-你的密钥 export ANTHROPIC_BASE_URLhttps://你的中转地址⚠️ 使用setx设置后需重新打开终端才能生效。 如果只想临时使用在 PowerShell 中用$env:方式设置即可关闭终端后失效。6.2 方式二settings.json推荐持久化Claude Code 的配置文件路径作用域路径说明用户级~/.claude/settings.json对所有项目生效项目级项目目录/.claude/settings.json仅对当前项目生效创建配置文件# 创建配置目录如果不存在 mkdir -p ~/.claude # 使用编辑器打开以 VS Code 为例 code ~/.claude/settings.json基础配置模板官方 API{ env: { ANTHROPIC_API_KEY: sk-ant-你的密钥, ANTHROPIC_BASE_URL: https://api.anthropic.com } }中转 API 配置模板{ env: { ANTHROPIC_BASE_URL: https://你的中转地址.com, ANTHROPIC_AUTH_TOKEN: sk-你的中转密钥 } } 使用中转 API 时密钥变量名可以是ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY二者等效。7. 第三方模型配置国内用户必看Claude Code 支持三种模型接入模式可根据你的 API 提供商选择对应方式。7.1 模式一Anthropic 兼容模式最常用适用于官方 API、模拟 Anthropic 协议的中转站、DeepSeekAnthropic 兼容端点{ env: { ANTHROPIC_BASE_URL: https://api.xxx.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }指定不同模型级别的映射{ env: { ANTHROPIC_BASE_URL: https://api.xxx.com, ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-20250514, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-20250514 } }7.2 模式二OpenAI Compatible 模式适用于使用 OpenAI Chat Completions 协议的服务商DeepSeek OpenAI 端点、智谱 GLM、通义千问等{ env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-chat,glm-4-plus,qwen-max, OPENAI_BASE_URL: https://api.deepseek.com/v1, OPENAI_API_KEY: sk-你的密钥 } }⚠️ OpenAI Compatible 模式下Claude Code 的部分内置功能如网络搜索可能不可用。7.3 模式三AWS Bedrock适用于使用 AWS 云服务的用户{ env: { CLAUDE_CODE_USE_BEDROCK: 1, AWS_REGION: us-west-2, AWS_ACCESS_KEY_ID: 你的AK, AWS_SECRET_ACCESS_KEY: 你的SK, ANTHROPIC_MODEL: us.anthropic.claude-sonnet-4-20250514-v1:0 } }7.4 模式四Google Cloud Vertex AI{ env: { CLAUDE_CODE_USE_VERTEX: 1, CLOUD_ML_REGION: us-east5, ANTHROPIC_VERTEX_PROJECT_ID: 你的项目ID, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }8. CC Switch 可视化工具配置CC Switch 是一个专为 Claude Code 打造的开源可视化模型切换工具GitHub 5.9k stars可以免去手动编辑配置文件的麻烦。8.1 CC Switch 简介特性说明零侵入保留 Claude Code 原生使用体验热切换切换模型无需重启多模型支持DeepSeek、GLM、Qwen、Kimi、Claude 等多设备同步支持配置文件云同步本地路由通过 127.0.0.1:15721 实现协议转换8.2 安装 CC Switch# 通过 npm 安装 npm install -g cc-switch # 启动 CC Switch cc-switch当前2026-07-01最新版是CC-Switch-v3.16.5-Windows.msiCC-Switch-v3.16.5-Windows.msi下载链接https://github.com/farion1231/cc-switch/releases/download/v3.16.5/CC-Switch-v3.16.5-Windows.msi8.3 CC Switch 配置步骤启动 CC Switch运行cc-switch或打开桌面应用添加 Provider点击「新增供应商」填入以下信息名称自定义如 DeepSeekBase URLAPI 端点地址API Key你的密钥模型 ID如deepseek-chat选择激活在供应商列表中点击激活启动 Claude Codeclaude即可使用配置的模型8.4 CC Switch 工作原理Claude Code → 127.0.0.1:15721CC Switch 本地路由→ 目标 API 服务商 ↓ 协议转换Anthropic → OpenAI / 其他协议9. VS Code / JetBrains IDE 集成9.1 VS Code 集成打开 VS Code进入扩展市场搜索Claude Code安装官方扩展在 VS Code 终端中运行claude即可9.2 VS Code 中使用第三方模型先按照第 6~8 节配置好环境变量或 settings.json然后在 VS Code 终端中启动 Claude Code 即可自动读取配置。9.3 JetBrains IDE 集成打开 JetBrains IDE如 IntelliJ IDEA、PyCharm进入Settings → Plugins搜索并安装Claude Code插件在内置终端中运行claude10. 常见模型 API 配置速查表10.1 DeepSeekAnthropic 兼容端点 { env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat } } 10.2 DeepSeekOpenAI 兼容端点 { env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-chat, OPENAI_BASE_URL: https://api.deepseek.com/v1, OPENAI_API_KEY: sk-你的DeepSeek密钥 } } 10.3 智谱 GLM / ZLM { env: { CLAUDE_CODE_OPENAI_MODELS: glm-4-plus, OPENAI_BASE_URL: https://open.bigmodel.cn/api/paas/v4, OPENAI_API_KEY: 你的智谱API密钥 } } 10.4 通义千问Qwen { env: { CLAUDE_CODE_OPENAI_MODELS: qwen-max, OPENAI_BASE_URL: https://dashscope.aliyuncs.com/compatible-mode/v1, OPENAI_API_KEY: 你的阿里云API密钥 } } 10.5 KimiMoonshot { env: { CLAUDE_CODE_OPENAI_MODELS: moonshot-v1-128k, OPENAI_BASE_URL: https://api.moonshot.cn/v1, OPENAI_API_KEY: 你的Kimi API密钥 } } 10.6 硅基流动 { env: { CLAUDE_CODE_OPENAI_MODELS: deepseek-v3,glm-4-plus, OPENAI_BASE_URL: https://api.siliconflow.cn/v1, OPENAI_API_KEY: 你的硅基流动密钥 } } 10.7 火山引擎豆包 Seed { env: { CLAUDE_CODE_OPENAI_MODELS: doubao-pro-256k, OPENAI_BASE_URL: https://ark.cn-beijing.volces.com/api/v3, OPENAI_API_KEY: 你的火山引擎密钥 } }11. 常见问题排查11.1 安装问题问题原因解决方案npm install -g报错网络超时国内访问 npm 官方源慢设置淘宝镜像npm config set registry https://registry.npmmirror.comPermission denied权限不足Windows 以管理员运行macOS/Linux 使用sudo npm install -gnode: command not foundNode.js 未安装按照第 3 节安装 Node.jsclaude: command not foundClaude Code 未安装或 PATH 问题重新运行npm install -g anthropic-ai/claude-code11.2 配置问题问题原因解决方案API Key 无效 / 401密钥拼写错误或已过期检查ANTHROPIC_AUTH_TOKEN值确认中转 Key 带sk-前缀Base URL 404URL 格式错误Anthropic 协议 URL 末尾不加/v1OpenAI 协议需加/v1环境变量未生效需要重启终端setx设置后必须新开终端settings.json 修改后重启claude模型权限错误模型未开通在 API 提供商后台开通对应模型的调用权限内置搜索不可用第三方模型限制使用/search off命令关闭搜索功能11.3 使用问题问题原因解决方案响应很慢网络延迟或模型负载检查网络连接尝试切换其他模型中文回答质量差模型选择问题切换到中文优化更好的模型如 GLM-4、Qwen文件读写权限报错目录权限不足确保 Claude Code 运行在项目目录中11.4 查看当前配置# 查看当前环境变量 echo $ANTHROPIC_BASE_URL # macOS/Linux echo %ANTHROPIC_BASE_URL% # Windows CMD echo $env:ANTHROPIC_BASE_URL # Windows PowerShell # 在 Claude Code 会话中查看 claude /config12. 参考资料官方文档Claude Code 官方文档中文Claude Code 模型配置Claude Code 设置API Key 管理社区教程Claude Code 安装配置完整指南 - 知乎Claude Code 国内使用完整教程 - 火山引擎Claude Code 安装教程附适配国内模型 - 腾讯云安装与多模型切换Windows/macOS - ClaudeCNClaude Code 国内安装 2026 最新教程 - 阿里云Claude Code 接入第三方 API - 腾讯云Claude Code API 配置 - 菜鸟教程CC Switch 工具CC Switch GitHub 仓库CC Switch 保姆级教程 - 知乎CC Switch 使用技巧 - 博客园CC Switch 多设备同步 - 火山引擎模型接入DeepSeek V4 接入 Claude Code - CSDNClaude Code CC Switch 配置 - Apifox智谱 Claude API 兼容接口AWS Bedrock 配置指南
