Claude Code 国内配置使用

Claude Code 国内配置使用

Claude Code 是 Anthropic 推出的 AI 编程助手，直接在终端里帮你写代码、改代码、跑命令。本文覆盖安装、API 配置（国内使用关键）和 VSCode 插件使用。

概述

Claude Code 是一种 Coding Agent 工具。它可以直接在终端交互（REPL 模式），也可以用 -p 参数跑一次性任务（适合 CI/自动化），还支持 MCP 工具集成和自定义子代理。

安装

安装方式已改为官方脚本，具体安装步骤可参考：https://www.runoob.com/claude-code/claude-code-install.html 这里不再赘述，下面直接配置 DeepSeek 大模型核心，其他大模型类似。

API 配置（国内使用核心）

为什么需要配置

Claude Code 默认调用的 Anthropic API 在国内无法直接访问。解决方法有两种：

方案	怎么做	优点	缺点
网络代理	设 HTTPS_PROXY 环境变量	功能最完整	需要稳定代理工具
API 中转	改用国内网关（如 DeepSeek）	无需代理，国内支付	需要修改配置文件

本文以 API 中转（DeepSeek） 为例。

文件位置

配置文件在：

Windows: C:\Users\你的用户名\.claude\settings.json

如果文件不存在，手动新建即可。文件内容是一个 JSON 对象，通过 "env" 字段覆盖环境变量。

完整配置示例

将 Claude Code 指向 DeepSeek 兼容网关：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}

环境变量说明

变量	作用
ANTHROPIC_BASE_URL	替换官方 API 地址，指向你自己的网关
ANTHROPIC_AUTH_TOKEN	API 密钥，走自定义网关时替代 ANTHROPIC_API_KEY
ANTHROPIC_MODEL	主聊天用的模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	简单后台任务（Haiku 层级）
ANTHROPIC_DEFAULT_SONNET_MODEL	中等后台任务（Sonnet 层级）
ANTHROPIC_DEFAULT_OPUS_MODEL	困难任务（Opus 层级）
CLAUDE_CODE_SUBAGENT_MODEL	子代理使用的模型

配置修改后重启 Claude Code 或 VSCode 插件才能生效。

模型分层策略

Claude Code 内部有四个任务层级，你可以给不同层级分配不同模型，做到"日常省钱，复杂用好模型"。这里只用了两个模型：

模型	分配到的层	用途
deepseek-v4-flash	主聊天 + Haiku + 子代理	日常使用，成本低
deepseek-v4-pro	Sonnet + Opus	复杂任务，更强推理

VSCode 插件

安装

在 VSCode 扩展市场搜索 Claude Code for VS Code 并安装。

跳过登录引导

如果不想走 OAuth 登录流程，可以手动标记已登录：

打开 C:\Users\你的用户名\.claude.json（注意不是 settings.json），在 {} 中添加一个字段：

{
  "hasCompletedOnboarding": true
}

两个配置文件别搞混

文件	路径	用途
.claude.json	C:\Users\你的用户名\.claude.json	全局设置，管登录状态等
settings.json	C:\Users\你的用户名\.claude\settings.json	Claude Code 运行配置，管模型和 API