通俗版 Claude Code 文档

结构照原 docs，内容改成真能照着做的人话版。
查看原始文档 目录顺序与官方保持一致

Model and responses

模型配置

模型相关设置怎么选，速度、成本和效果怎么拿捏。

页面信息

对应原页

Model configuration

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这页讲模型怎么配，不同模型该在什么活上出场。

说白了，就是选对工种。

有的模型像慢工细活的老师傅，有的像跑得快的短工。

这一页会帮助你分清速度、成本、效果之间怎么拿捏。

选对了，干活更顺；选错了，不是慢就是贵，要么效果还一般。

先按活路来选模型，不要只盯最强或最便宜。

团队统一使用时，最好先定几个默认挡位。

模型配置最好和成本、快速模式一起看。

终端里敲

原页关键片段：Setting your model 1

真到动手的时候了，下面这条直接敲一遍，看它回什么。

# Start with Opus
claude --model opus

# Switch to Sonnet during session
/model sonnet
改配置

原页关键片段：Setting your model 2

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
    "permissions": {
        ...
    },
    "model": "opus"
}
改配置

原页关键片段：Restrict model selection

这一段说完，最后还得写到配置里才算真的生效。

{
  "availableModels": ["sonnet", "haiku"]
}
改配置

原页关键片段：Control the model users run on

这一段说完，最后还得写到配置里才算真的生效。

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}
终端里敲

原页关键片段：Extended context

真到动手的时候了，下面这条直接敲一遍，看它回什么。

# Use the opus[1m] or sonnet[1m] alias
/model opus[1m]
/model sonnet[1m]

# Or append [1m] to a full model name
/model claude-opus-4-7[1m]
终端里敲

原页关键片段：Add a custom model option

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-7"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"
终端里敲

原页关键片段：Pin models for third-party deployments

真到动手的时候了，下面这条直接敲一遍，看它回什么。

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7[1m]'
关键片段

原页关键片段：Customize pinned model display and capabilities

"Customize pinned model display and capabilities"这一段里最要紧的原始写法在下面，先看它怎么落地。

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'
改配置

原页关键片段：Override model IDs per version

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

Available models

这一块主要是在说"Available models"真到手上该怎么用，哪里最容易踩坑。

Model aliases

看到这里，就把"Model aliases"当成一件真要上手的活来看。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

Setting your model

这里不是让你背"Setting your model"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Setting your model 1

真到动手的时候了，下面这条直接敲一遍，看它回什么。

# Start with Opus
claude --model opus

# Switch to Sonnet during session
/model sonnet
改配置

Setting your model 2

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
    "permissions": {
        ...
    },
    "model": "opus"
}

Restrict model selection

看到这里，就把"Restrict model selection"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Restrict model selection

这一段说完，最后还得写到配置里才算真的生效。

{
  "availableModels": ["sonnet", "haiku"]
}

Default model behavior

这里主要是在交代"Default model behavior"这一块会碰到哪些事。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Control the model users run on

看到这类标题，就把它当成日常管摊子的规矩。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Control the model users run on

这一段说完，最后还得写到配置里才算真的生效。

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Merge behavior

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Mantle model IDs

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

Special model behavior

这里不是让你背"Special model behavior"这个词，而是让你看它真干活时怎么使。

default model setting

这段看着像个标题，其实是在说"default model setting"管到哪儿。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

opusplan model setting

这一段不只是挂个标题，它是在说明"opusplan model setting"这一块到底负责什么。

Adjust effort level

这一块主要是在说"Adjust effort level"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Extended thinking

这一块主要是在说"Extended thinking"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Extended context

这里不是让你背"Extended context"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Extended context

真到动手的时候了，下面这条直接敲一遍，看它回什么。

# Use the opus[1m] or sonnet[1m] alias
/model opus[1m]
/model sonnet[1m]

# Or append [1m] to a full model name
/model claude-opus-4-7[1m]

Checking your current model

看到这里，就把"Checking your current model"当成一件真要上手的活来看。

Add a custom model option

这一段是在说怎么用 ANTHROPIC_CUSTOM_MODEL_OPTION to add a single custom entry 去做 the /model picker without replacing the built-in aliases. This is useful for testing model IDs that Claude Code does not list by default. For LLM gateway deployments, Claude Code can populate the picker from the gateway’s /v1/models endpoint when CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 is set, so this variable is needed only when discovery is disabled or does not return the model you want. See LLM gateway model selection.。看这种内容，光知道名字没用，还是得落到手上。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

终端里敲

Add a custom model option

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-7"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

Environment variables

这里不是让你背"Environment variables"这个词，而是让你看它真干活时怎么使。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

Pin models for third-party deployments

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Pin models for third-party deployments

真到动手的时候了，下面这条直接敲一遍，看它回什么。

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7[1m]'

Customize pinned model display and capabilities

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

关键片段

Customize pinned model display and capabilities

"Customize pinned model display and capabilities"这一段里最要紧的原始写法在下面，先看它怎么落地。

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

Override model IDs per version

这里主要是在交代"Override model IDs per version"这一块会碰到哪些事。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Override model IDs per version

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

Prompt caching configuration

看到这里，就把"Prompt caching configuration"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

照着做一遍

如果你不想来回翻，就先照这几步顺着做。

每做完一步就看一下结果，再决定要不要继续往下。

终端里敲

第 1 步：Setting your model 1

真到动手的时候了，下面这条直接敲一遍，看它回什么。

# Start with Opus
claude --model opus

# Switch to Sonnet during session
/model sonnet
改配置

第 2 步：Setting your model 2

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
    "permissions": {
        ...
    },
    "model": "opus"
}
改配置

第 3 步：Restrict model selection

这一段说完，最后还得写到配置里才算真的生效。

{
  "availableModels": ["sonnet", "haiku"]
}
改配置

第 4 步：Control the model users run on

这一段说完，最后还得写到配置里才算真的生效。

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

一眼看懂这一页

先把这页到底在讲什么看明白，再去碰具体命令和配置，最不容易绕晕。

Model configuration
   |
   v
这是 Model and responses 里的一摊要紧活
   |
   v
先弄懂，再下手

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。

预留广告位

文末横幅广告 适合放在文章读完以后，不抢首屏注意力。