简介
Claude Code 是有 Anthorpic 公司退出的一款高效的 AI Agent 编程助手，可以帮助程序员解放双手，实现高效的软件开发工作。
安装与配置
软件安装使用一行命令实现，参考文档
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
如果要跳过登录验证，需要在 ~/.claude.json 文件下添加配置:
{"hasCompletedOnboarding": true
}
Claude Code 的配置目录在 ~/.claude/settings.json 中，基础配置如下：
{"env": {"ANTHROPIC_AUTH_TOKEN": "sk-**","ANTHROPIC_BASE_URL": "https://api.****/anthropic","ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"...},"includeCoAuthoredBy": false,"skipWebFetchPreflight": true,"effortLevel": "high","skipDangerousModePermissionPrompt": true
}
| 变量 | 目的 |
|---|---|
| ANTHROPIC_API_KEY | 作为 X-Api-Key 标头发送的 API 密钥，通常用于 Claude SDK（对于交互式使用，运行 /login） |
| ANTHROPIC_AUTH_TOKEN | Authorization 标头的自定义值（您在此处设置的值将以 Bearer 为前缀） |
| ANTHROPIC_CUSTOM_HEADERS | 您想要添加到请求的自定义标头（以 Name: Value 格式） |
| ANTHROPIC_MODEL | 要使用的模型设置名称 |
| BASH_DEFAULT_TIMEOUT_MS | 长时间运行的 bash 命令的默认超时 |
| BASH_MAX_OUTPUT_LENGTH | bash 输出在中间截断之前的最大字符数 |
| BASH_MAX_TIMEOUT_MS | 模型可以为长时间运行的 bash 命令设置的最大超时 |
| CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | 在每个 Bash 命令后返回到原始工作目录 |
| CLAUDE_CODE_API_KEY_HELPER_TTL_MS | 凭证应刷新的间隔（毫秒）（使用 apiKeyHelper 时） |
| CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | 跳过 IDE 扩展的自动安装 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 为大多数请求设置最大输出令牌数 |
| CLAUDE_CODE_SUBAGENT_MODEL | 参见模型配置 |
| DISABLE_TELEMETRY | 设置为 1 以选择退出 Statsig 遥测（注意 Statsig 事件不包括用户数据，如代码、文件路径或 bash 命令） |
| MAX_MCP_OUTPUT_TOKENS | MCP 工具响应中允许的最大令牌数。当输出超过 10,000 个令牌时，Claude Code 显示警告（默认：25000） |
| MAX_THINKING_TOKENS | 强制模型预算的思考 |
| MCP_TIMEOUT | MCP 服务器启动的超时（毫秒） |
| MCP_TOOL_TIMEOUT | MCP 工具执行的超时（毫秒） |
| USE_BUILTIN_RIPGREP | 设置为 0 以使用系统安装的 rg 而不是 Claude Code 包含的 rg |
includeCoAuthoredBy
mcpServers
"mcpServers": {"MiniMax": {"type": "stdio","command": "uvx","args": ["minimax-coding-plan-mcp","-y"],"env": {"MINIMAX_API_KEY": "sk-cp-**","MINIMAX_API_HOST": "https://api.minimaxi.com"}},"chrome-devtools": {"command": "npx","args": ["-y","chrome-devtools-mcp@latest","--browser-url=http://127.0.0.1:9222"]}
}
在跳过权限确认模式下启动 Claude
claude --dangerously-skip-permissions
Claude Code 插件 cc-switch
cc-switch 全称是 Claude Code Switch， 是一个用于管理 Claude Code 配置的工具，它提供了一个完整的 UI 界面，方便通过界面选项实现 Claude Code 在不同大模型供应商直接切换。官方连接
让 Claude Code 可以控制 Chrome
方式1
Claude Code 官方提供一个Chrome浏览器插件，可以让Claude Code在 Chrome 上实现页面调试，官方文档
方式2
使用chrome官方插件 chrome-devtools
命令行安装 chrome-devtools mcp
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
方式3
使用 BrowerTool
Claude Code Skill 机制
# 前端设计技能
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code# 文档协同技能
npx skills-installer install @anthropics/claude-code/doc-coauthoring --client claude-code# Canvas 设计技能
npx skills-installer install @anthropics/claude-code/canvas-design --client claude-code# PDF 处理技能
npx skills-installer install @anthropics/claude-code/pdf --client claude-code# 算法艺术生成
npx skills-installer install @anthropics/claude-code/algorithmic-art --client claude-code
遇到的问题
问题1: 读取网页技术文档遇到反扒机制
丢一个技术文档的链接让claude code查看，但是会有反爬机制导致claude code读不到内容，此时可以通过以下两个网站中转，绕过反扒机制：
https://r.jina.ai/{your_url}
https://defuddle.md/{your_url}
Defuddle 是一个工具站点，用于将任何网页转换为 markdown 内容输出，结果非常适合喂给大模型作为输入
问题2: WebFetch 报错 Unable to verify if domain xxx is safe
使用 Claude Code 的 WebFetch 一致报错：
Unable to verify if domain xxx is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
根本原因在于 WebFetch 在抓取目标网站之前，会先调用 https://claude.ai/api/web/domain_info?domain= 做安全验证。如果你的网络环境下 claude.ai 被墙或者被企业防火墙拦了，这个预检查就会失败，即使目标网站本身是可以访问的。详情参考 #Issue6388
解决方案: Claude Code 其实提供了一个配置项 skipWebFetchPreflight 可以跳过预检查，通过编辑 %userprofiel%/.claude/settings.json 添加如下配置:
{"skipWebFetchPreflight": true
}
完成后重新打开 Claude Code 并抓取验证，会发现可以正常抓取了。
参考资料
- Claude Code 源码解读
- Claude Code 教程指北
- Claude Code 上手指南