Anthropic配置主要指两块——一是通过settings.json文件设置环境变量、权限、MCP服务器这些行为控制项;二是直接在终端里设置系统环境变量,临时或者永久指定API Key、模型、代理地址。两种方式都能达到同样效果,看你是想一次性用还是长期固定用。下面细说具体怎么配。
一、Anthropic配置文件放在哪儿
settings.json这个文件,macOS和Linux上放在~/.claude/settings.json,Windows上放在用户目录下的.claudesettings.json。这是用户级配置,对当前用户所有项目都生效。如果只想针对某一个项目单独配,可以在项目根目录下建.claude/settings.json,这个优先级比用户级的高,会覆盖或叠加到用户设置上。企业如果部署了统一管理策略,还有一层managed/policy级别的配置,优先级最高,能强制锁定用户能用哪些模型、哪些操作。 优先级顺序大致是:企业策略>项目设置>用户设置,层级越具体,优先级越高,设置之间是合并关系,不是简单的覆盖。
二、核心字段都有哪些
1、认证相关
这块是配置里最容易踩坑的地方。常用的有ANTHROPIC_API_KEY(官方Key直接用这个)和ANTHROPIC_AUTH_TOKEN(对接第三方兼容平台时常用这个字段名,具体用哪个看你接的服务商文档要求)。配合ANTHROPIC_BASE_URL指定请求要打到哪个地址,官方默认是https://api.anthropic.com,如果你在用别的兼容服务,把这个换成对应的地址就行。
2、模型选择
用ANTHROPIC_MODEL指定Claude Code默认调用哪个模型。这里得提一句,网上不少教程写的模型名字是claude-opus-4-6、claude-sonnet-4-6这类,这些都是几个月前的旧版本号了,现在Anthropic当前在用的模型是Claude Fable 5(claude-fable-5)、Claude Opus 4.8(claude-opus-4-8)、Claude Sonnet 5(claude-sonnet-5)、Claude Haiku 4.5(claude-haiku-4-5-20251001),写配置的时候记得对着最新的模型名来,别照抄旧文章里的版本号,不然容易调用失败或者拿到你没预期的模型。 3、模型槽位映射
像ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL这几个字段,主要是在接入第三方兼容服务(比如某些国内平台提供的中转API)时用,作用是把Claude Code内部原本对应到Sonnet、Opus、Haiku这几档的调用,重新映射到服务商实际提供的模型名字上,不然直接用官方模型名可能在第三方平台上找不到对应模型,报错。
4、超时设置
API_TIMEOUT_MS用来调整请求超时时间,默认值有时候对于大任务不够用,可以调大一点,单位是毫秒。
5、隐私相关
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设成1可以关掉一些非必要的遥测流量上报,注重隐私或者网络环境受限的话可以开这个。
6、权限控制
通过permissions.allow和permissions.deny来精细控制Claude Code能干什么、不能碰什么。比如想防止它读取包含密钥的敏感文件,可以这样写:
json
{
"permissions":{"
deny":
["Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
]
}
}
匹配到这些规则的文件,对Claude Code来说是完全不可见的,能有效防止意外把密钥、凭证暴露给它。
7、MCP服务器
如果想让Claude Code接入额外的工具和外部服务(比如连接数据库、调用某个内部系统),也是在settings.json里配置对应的MCP server信息,这块跟核心的API配置是分开的独立字段。
三、完整配置示例长什么样
把上面这些字段拼一块,一个相对完整的配置大概是这样:
json
{
"env":{
"ANTHROPIC_API_KEY":"你的API密钥",
"ANTHROPIC_BASE_URL":"https://api.anthropic.com",
"ANTHROPIC_MODEL":"claude-sonnet-5",
"API_TIMEOUT_MS":"3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1"},
"permissions":{"allow":["Bash(git status:)","Bash(npm test:)"],
"deny":["Read(./.env)"]
}
}
改完保存,记得重新打开一个新的终端窗口,环境变量才会生效,老窗口里改了不会自动刷新。
四、配完了怎么确认是否生效
进到Claude Code里,输入/status命令,能看到当前实际生效的ANTHROPIC_BASE_URL、模型这些配置信息。如果发现它显示的地址不是你设置的那个,或者显示为空,大概率是配置文件没保存对地方,或者终端没重启导致环境变量没刷新过去,回头检查一下文件路径和格式,重开个终端再试一遍基本就能解决。
另外也可以直接用系统环境变量的方式临时设置,不改配置文件,比如在终端里直接export ANTHROPIC_API_KEY="你的Key"再跑claude,这种方式只在当前会话里生效,适合临时测试,不想每次都写进配置文件的话可以用这招。
anthropic配置这件事说到底就是围绕settings.json和几个核心环境变量在转——认证信息配对、模型名字写对、权限该锁的锁上,基本上就能顺畅用起来了,遇到不生效的情况,先用/status查一遍,大部分问题都能当场定位。