一、API 凭证(API Keys & Auth)
除了使用
claude login 快捷浏览器授权外,极客可以直接在环境变量中配置 API 密钥,适用于 CI/CD 或远程服务器:
export ANTHROPIC_API_KEY="sk-ant-api03-..."
二、模型配置(Models & Providers)
Claude Code 支持动态切换 AI 模型。您可以使用
/model 命令在交互时切换,或在启动时通过 claude --model claude-haiku-4-5 指定模型。不仅支持 Anthropic 第一方模型,还可以配置 ANTHROPIC_BASE_URL 接入兼容的网关。
三、MCP 服务器配置(MCP Servers)
使用
/mcp add <command> 可以为 Claude Code 挂载 Model Context Protocol 服务器。所有挂载的配置将保存在您的主目录或当前项目的全局配置中,允许模型与本地或外部资源交互。
四、交互式 `/config` 命令与完整配置参数表(Themes & Parameters)
Claude Code 提供了高自由度的
配置示例与常用命令:
/config 斜杠命令,让开发者无需重启程序即可微调全局运行参数:
| 配置项 (Key) | 控制用途 (Description) | 合法取值 (Value Range) | 默认值 (Default) |
|---|---|---|---|
| editor | 设置编辑大型文件或长篇注释时调用的系统外部编辑器。 | "code --wait", "vim", "nano", "cursor --wait" 等有效 shell 命令 |
(空,默认使用标准交互输入) |
| theme | 控制终端内部分类图标与高亮的主题样式。 | "dark", "light", "system" |
"system" |
| maxPromptTokens | 设定每次请求的最大 Token 上限,防止在超大项目中误操作导致高额计费。 | 1000 ~ 200000 (正整数) |
200000 (200K) |
| verbose | 控制是否在终端输出底层的 API 请求细节与推理耗时日志。 | true, false |
false |
| autoAccept | 是否跳过危险命令与文件修改的 Y/N 确认拦截提示。非极特殊环境极力阻止开启。 | true, false |
false |
| customPrompt | 追加项目的全局个性化自定义系统规约,例如代码缩进和风格守则。 | 任意文本字符串 | (空) |
# 设置配置参数 /config set editor "code --wait" # 查询指定配置状态 /config get theme # 查看或导出当前生效的完整配置清单 /config list
五、CLI 标志位(CLI Flags)
常见参数包含
--auto-accept(自动接受审批)、--org <ID>(指定组织)、--project <ID>(指定项目)、--verbose(打印底层日志),以及 --dangerously-skip-permissions(跳过权限验证,极度危险)。
六、归属追踪与工具白名单(Attribution & Allowed Tools)
配置
--prompt-suffix 为每次模型请求添加固定后缀(例如计费标签)。使用 allowed tools 在内部配置文件中精确白名单化模型可以自由调用的工具(如 bash、fs_read 等),严控越权调用。
七、权限与工作区隔离(Permissions & Sandbox/Worktree)
Agent 受到极其严格的文件沙箱限制。默认仅能修改当前
git worktree 内的文件。超出当前项目路径的访问、任何系统级的 Bash 命令执行(删除、安装包等),均需要控制台终端出现黄色警告哨卫拦截并由用户输入 'Y' 确认。