目录Claude Code 安装完全指南从入门到精通为什么选择 Claude Code一、安装前准备系统要求需要准备二、安装步骤方法一Native 安装推荐macOS / LinuxWindows (PowerShell)方法二NPM 安装验证安装首次运行三、API 密钥配置获取 Anthropic API 密钥环境变量配置临时配置当前会话永久配置四、常见问题与解决方案诊断命令五、接入自定义模型GLM/OpenAI 等配置文件位置GLM 模型配置示例OpenAI 兼容端点配置Azure OpenAI 配置环境变量方式不使用配置文件六、MCP 服务器配置什么是 MCPMCP 配置文件位置联网搜索 MCP视频理解 MCP文件系统 MCPGitHub MCPBrave Search MCPMCP 调试七、实用命令速查八、实战案例案例 1使用 GLM 模型开发 Node.js 项目案例 2配置联网搜索进行技术调研案例 3视频内容分析工作流九、配置模板下载模板 1GLM 模型配置模板 2全局 MCP 配置模板 3项目级 MCP 配置十、进阶技巧项目级设置自动补全Hooks 配置参考资源结语Claude Code 安装完全指南从入门到精通Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手让编写代码像聊天一样简单。为什么选择 Claude Code真正的本地开发直接在你的终端中工作无需切换窗口强大的代码理解理解整个项目结构提供上下文感知的建议MCP 协议支持轻松接入各种工具和服务视频理解、联网搜索等多模型支持可接入 GLM、OpenAI 等自定义模型免费使用使用自己的 API 密钥按需付费一、安装前准备系统要求操作系统支持版本macOSmacOS 11Linux主流发行版 (Ubuntu, Debian, CentOS 等)WindowsWindows 10/11 with PowerShell需要准备Anthropic API 密钥或自定义模型 API 密钥获取地址https://console.anthropic.com/Node.js仅 NPM 安装方式需要版本要求Node.js 18获取地址https://nodejs.org/en/download二、安装步骤方法一Native 安装推荐这是官方推荐的安装方式下载预编译的二进制文件。macOS / Linuxcurl-fsSLhttps://cdn.jsdelivr.net/npm/claude-code/standalone/install.sh|shWindows (PowerShell)powershell-cirm https://cdn.jsdelivr.net/npm/claude-code/standalone/install.ps1 | iex方法二NPM 安装适合熟悉 Node.js 生态的开发者。npminstall-ganthropic-ai/claude-code验证安装claude--version如果输出版本号如claude-code version 1.0.0说明安装成功首次运行claude首次运行会引导你配置 API 密钥。三、API 密钥配置获取 Anthropic API 密钥访问 https://console.anthropic.com/注册/登录账号进入 API Keys 页面创建新的 API 密钥环境变量配置临时配置当前会话# macOS / LinuxexportANTHROPIC_API_KEYyour-api-key-here# Windows PowerShell$env:ANTHROPIC_API_KEYyour-api-key-here永久配置macOS / Linux- 添加到~/.zshrc或~/.bashrcechoexport ANTHROPIC_API_KEYyour-api-key-here~/.zshrcsource~/.zshrcWindows- 使用系统环境变量[System.Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY,your-api-key-here,User)四、常见问题与解决方案问题原因解决方案command not found: claudePATH 未配置或安装失败重新运行安装脚本或重启终端检查~/.local/bin是否在 PATH 中返回 HTML 内容而非脚本网络问题或 CDN 访问受限使用 VPN或改用 NPM 安装方式Raw mode is not supportedWindows Git Bash 兼容性问题使用 PowerShell 或 CMD 运行安装命令首次运行无响应配置文件冲突或权限问题运行claude doctor诊断或删除~/.claude后重新配置API 调用失败API 密钥无效或网络问题检查密钥是否正确确认网络可访问 API 端点诊断命令claude doctor# 运行完整诊断claude config# 重新配置五、接入自定义模型GLM/OpenAI 等Claude Code 支持通过配置文件接入兼容 OpenAI/Anthropic API 的自定义模型。配置文件位置~/.claude/settings.jsonGLM 模型配置示例智谱 GLM-4.6 是国内领先的中文大模型通过以下配置即可使用{env:{ANTHROPIC_AUTH_TOKEN:your-glm-api-key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.6}}获取 GLM API 密钥https://open.bigmodel.cn/OpenAI 兼容端点配置{env:{ANTHROPIC_AUTH_TOKEN:your-openai-api-key,ANTHROPIC_BASE_URL:https://api.openai.com/v1,ANTHROPIC_DEFAULT_SONNET_MODEL:gpt-4o}}Azure OpenAI 配置{env:{ANTHROPIC_AUTH_TOKEN:your-azure-api-key,ANTHROPIC_BASE_URL:https://your-resource.openai.azure.com/openai/anthropic,ANTHROPIC_DEFAULT_SONNET_MODEL:gpt-4o}}环境变量方式不使用配置文件你也可以直接设置环境变量而不修改配置文件exportANTHROPIC_AUTH_TOKENyour-glm-api-keyexportANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropicexportANTHROPIC_DEFAULT_SONNET_MODELglm-4.6六、MCP 服务器配置什么是 MCPMCPModel Context Protocol是 Anthropic 推出的开放协议让 AI 助手能够安全地访问外部工具和数据源。MCP 配置文件位置全局配置~/.claude.json项目配置.mcp.json项目根目录联网搜索 MCP使用 GLM 的联网搜索服务让 Claude 能够获取最新信息{mcpServers:{web-search-prime:{type:http,url:https://open.bigmodel.cn/api/mcp/web_search_prime/mcp,headers:{Authorization:Bearer YOUR_GLM_API_KEY}}}}使用示例帮我搜索 React 19 的新特性视频理解 MCP通过 zai 的 MCP 服务器让 Claude 能够理解和分析视频内容{mcpServers:{zai-mcp-server:{type:stdio,command:npx,args:[-y,z_ai/mcp-server],env:{Z_AI_API_KEY:YOUR_ZAI_API_KEY}}}}获取 API 密钥https://zai.ai/文件系统 MCP官方内置的文件系统访问能力{mcpServers:{filesystem:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-filesystem,/path/to/allowed/directory]}}}GitHub MCP访问 GitHub 仓库信息{mcpServers:{github:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-github],env:{GITHUB_TOKEN:your-github-token}}}}Brave Search MCP使用 Brave 搜索 API{mcpServers:{brave-search:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-brave-search],env:{BRAVE_API_KEY:your-brave-api-key}}}}MCP 调试claude --mcp-debug# 启用 MCP 调试模式七、实用命令速查# 版本信息claude--version# 查看当前版本# 配置相关claude config# 重新运行配置向导claude doctor# 运行诊断检查# MCP 相关claude --mcp-debug# 启动时显示 MCP 调试信息claude --no-mcp# 禁用 MCP 服务器# 帮助claude--help# 显示所有可用选项claude --help-advanced# 显示高级选项八、实战案例案例 1使用 GLM 模型开发 Node.js 项目场景接入智谱 GLM-4.6 模型进行中文项目开发步骤配置~/.claude/settings.json{env:{ANTHROPIC_AUTH_TOKEN:your-glm-api-key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.6}}创建项目并验证mkdirmy-node-appcdmy-node-app claude在 Claude Code 中输入帮我创建一个 Express.js 服务器包含用户注册和登录接口案例 2配置联网搜索进行技术调研场景使用 MCP 搜索最新技术文档和最佳实践步骤配置~/.claude.json添加联网搜索 MCP{mcpServers:{web-search-prime:{type:http,url:https://open.bigmodel.cn/api/mcp/web_search_prime/mcp,headers:{Authorization:Bearer YOUR_GLM_API_KEY}}}}重启 Claude Code然后使用搜索搜索 Next.js 15 App Router 的最佳实践帮我了解 2025 年前端性能优化的最新趋势案例 3视频内容分析工作流场景使用视频理解 MCP 分析教程视频提取关键知识点步骤配置~/.claude.json添加视频理解 MCP{mcpServers:{zai-mcp-server:{type:stdio,command:npx,args:[-y,z_ai/mcp-server],env:{Z_AI_API_KEY:YOUR_ZAI_API_KEY}}}}在 Claude Code 中使用请分析这个视频教程的内容提取所有关键知识点和代码示例./tutorial.mp4帮我把这个视频的内容整理成 Markdown 文档demo.mp4九、配置模板下载以下模板文件已准备就绪可直接使用或修改模板 1GLM 模型配置文件claude-settings.json{env:{ANTHROPIC_AUTH_TOKEN:YOUR_GLM_API_KEY,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.6}}模板 2全局 MCP 配置文件claude-mcp.json{mcpServers:{web-search-prime:{type:http,url:https://open.bigmodel.cn/api/mcp/web_search_prime/mcp,headers:{Authorization:Bearer YOUR_GLM_API_KEY}},filesystem:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-filesystem,/Users/minh/projects]},github:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-github],env:{GITHUB_TOKEN:YOUR_GITHUB_TOKEN}}}}模板 3项目级 MCP 配置文件.mcp.json放在项目根目录{mcpServers:{project-filesystem:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-filesystem,.]},postgres:{type:stdio,command:npx,args:[-y,modelcontextprotocol/server-postgres,postgresql://user:passwordlocalhost:5432/dbname]}}}十、进阶技巧项目级设置在项目根目录创建.clauderc文件可以为特定项目设置不同的配置# .claudercexportANTHROPIC_DEFAULT_SONNET_MODELglm-4.6exportCUSTOM_PROJECT_VARvalue自动补全macOS / Linux# 添加到 ~/.zshrc 或 ~/.bashrceval$(claude --shell-completion)Windows PowerShell# 添加到 $PROFILEInvoke-Expression(claude--shell-completion)Hooks 配置在~/.claude/settings.json中配置 hooks在特定事件触发自定义脚本{hooks:{PreToolUse:echo About to use tool: ~/.claude/tool-log.txt,PostToolUse:echo Tool used ~/.claude/tool-log.txt}}参考资源Claude Code 官方文档Anthropic API 文档MCP 协议规范智谱 AI 开放平台Claude Code 中文文档结语Claude Code 是一个强大的 AI 编程助手通过本教程你应该已经掌握了基础安装和配置自定义模型接入如 GLMMCP 服务器配置和使用如有问题欢迎在评论区讨论或查阅官方文档获取更多信息。Happy Coding!