企业官网建设流程全解析

1. Claude Code 是什么：先建立全景认识

1.1 核心定位：终端里的结对编程助手

Claude Code 是 Anthropic 推出的一款跑在终端里的编程助手。它不像普通聊天机器人那样只给你一段回答，而是能直接读取你的项目目录、查看文件、运行命令、修改代码，然后把结果反馈给你。我第一次用的时候最直观的感受是：它像一个愿意自己动手的结对程序员坐在你旁边，你不光能跟它讨论思路，还能直接让它改 bug、补测试、跑构建。

它解决的核心问题很明确：把“聊代码”和“改代码”之间那层传递成本降到最低。传统 AI 编程流程是“复制代码到对话框 -> 等结果 -> 再粘贴回来”，Claude Code 的模式是“直接在项目里开工”，所有操作都发生在你本地的上下文里。适合的人群也很广：独立开发者、前端/后端工程师、运维、数据工程，甚至刚入门编程但能操作终端的新手。

因为标题里带了“中英文教程”，我多说一句：这篇记录里的核心术语我都会保留英文原词，比如 CLI、Agent、MCP，中文含义会同步解释。这样你以后去查官方文档、搜 GitHub issue，不会被中文翻译带偏。

1.2 关键术语中英文对照

1.3 适合谁用，解决什么问题

如果你是纯新手，从没碰过终端，Claude Code 的上手门槛主要在安装环节，跨过去之后反而比 IDE 插件更简单——因为所有交互都收在一个命令行窗口里。如果你是有经验的开发者，它最有价值的地方是处理重复劳动：重构命名、补测试用例、批量修改文件、解释陌生项目结构。运维类需求它也能干，比如让你执行命令、看日志、排查端口占用，配合“直接执行终端命令”的能力，效率上限很高。

2. 安装前的准备与环境要求

2.1 确认系统与运行时

Claude Code 本质上是一个基于 Node.js 的命令行工具，所以最推荐、最稳的安装路径是 npm 全局安装。在你执行安装命令之前，先确认三件事：

• 系统：Windows 10/11、macOS、Ubuntu 等主流 Linux 发行版都支持。
• Node.js 版本：建议 18 以上，最好直接上 20 LTS 或更新版本。版本太低会出现找不到模块、安装失败等奇怪问题。
• 终端环境：Windows 推荐使用 PowerShell 或 Windows Terminal，Linux/macOS 用系统自带终端即可。

检查 Node 版本的命令是：

node -v npm -v

如果提示node: command not found，说明 Node.js 还没装。macOS 可以用 Homebrew 装：

brew install node

Ubuntu/Debian 系列系统不建议直接apt install nodejs，因为版本往往偏旧。我更推荐先装 nvm（Node Version Manager），再用 nvm 装指定版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 20

Windows 用户直接去 Node.js 官网下载 LTS 安装包即可，安装时勾选“Add to PATH”。

2.2 账号与订阅怎么选

很多人一开始都会纠结注册账号和不注册账号的区别。我直接给你拆清楚：

实际体验上的差异也很明显：用 Claude 账号登录时，命令输入框里能看到订阅套餐状态，模型能力默认拉满。不登录直接启动，只会看到欢迎界面，无法真正对话。如果你用 API Key 或第三方模型，Claude Code 会通过环境变量识别身份，启动时完全跳过登录流程，直接进入工作状态。

提示：如果你在团队或公司环境下使用，遇到your organization has disabled claude subscription access for claude code这类提示，说明组织策略层面关闭了 Claude Code 的订阅访问通道，这属于管理员在后台配置的开关，不是本地能改的设置。

3. 安装与升级实操：Windows、macOS、Ubuntu

3.1 推荐路径：npm 全局安装

无论你用哪个操作系统，只要 Node.js 环境正常，安装命令只有一条：

npm install -g @anthropic-ai/claude-code

安装完成后验证版本：

claude --version

如果能输出版本号，说明安装成功。接下来直接在项目目录里启动：

cd your-project claude

第一次运行会引导你完成登录流程。如果你没有 Claude 账号，可以先注册一个免费账号，或者准备好 API Key 后通过环境变量方式启动。

macOS 用户如果不想通过 npm，也可以用官方提供的原生安装脚本，具体命令以官方文档为准。Ubuntu 系统同样支持原生安装，但我的建议是优先 npm，因为后续升级和维护更统一，不容易出现权限问题。

3.2 原生安装器与桌面版

除了 npm 包，Claude Code 官方也提供原生安装器，适合不想碰 Node 生态的人。原生安装的好处是启动更快、不依赖 npm 全局目录权限。缺点是不同平台的安装包区别较大，Windows 上还容易出现“位数不匹配”的报错，所以没有特殊需求时我仍然建议 npm。

关于桌面版，注意区分两个概念：一个是 Claude 的桌面客户端，另一个是 Claude Code 桌面版。命名上容易混淆。你在官方文档里搜到的 “Claude Code Desktop” 通常是 CLI 的图形化配套入口，本质还是同一个引擎。安装包尽量从官方渠道下载，第三方站点发布的“桌面版安装包”版本陈旧，反而容易触发兼容性问题。

3.3 在线升级到最新版本

Claude Code 的版本迭代很快，新模型、新工具调用方式经常跟着版本走。查版本和升级：

# 查看当前版本 claude --version # 如果有自动更新提示，在交互式会话里执行 claude update # 或者直接用 npm 强制升级 npm install -g @anthropic-ai/claude-code@latest

我习惯每次写代码前顺手跑一句claude --version，看到有新版就直接升。有一个细节：如果你是通过原生安装器装的，用claude update更合适；如果你是通过 npm 装的，npm install -g会覆盖旧版本，两条路不要混用，否则可能出现“命令还在，但版本没变”的错觉。

4. VS Code 接入与桌面端配置

4.1 安装官方扩展

Claude Code 的命令行体验很好，但不少场景我还是要回到 VS Code 里看代码、看 diff。这时候直接切终端有点打断节奏，所以 Anthropic 官方提供了 VS Code 扩展。

打开 VS Code 扩展市场，搜索 “Claude Code”，认准官方发布者，点击安装。装完之后左侧会出现对应图标，点击图标就能在编辑器侧边栏直接启动一个 Claude Code 会话。它的底层还是命令行工具，所以你在终端里已有的登录状态、模型配置、权限设置都会同步生效。

命令行和扩展二选一也完全没问题，但我的使用体验是：集中式重构的时候用终端更顺手，边看代码边问问题的时候用扩展更直观。两者共用同一套项目上下文，不会出现“这边聊完那边不知道”的问题。

4.2 扩展配置细节

VS Code 扩展最常见的配置问题是找不到claude命令。原因通常是全局 npm 目录没有加入 PATH。解决办法是在 VS Code 设置里手动指定：

{ "claude-code.path": "/usr/local/bin/claude", "claude-code.autoStart": true, "claude-code.cwd": "${workspaceFolder}" }

其中claude-code.path要填你本机claude命令的实际路径。macOS/Linux 下可以用which claude查到，Windows 下通常在 npm 全局目录下。

claude-code.autoStart控制是否在打开工作区时自动初始化 Claude Code 会话，我建议关掉，等需要时再手动启动，不然每次打开项目都要等初始化。claude-code.cwd表示运行目录，默认是当前工作区，如果你需要固定跑某个子项目，改成子项目路径更稳妥。

如果你需要在扩展里使用第三方模型，对应环境变量同样要配置到 VS Code 的 settings.json 里，而不是只在终端里 export。因为扩展启动的 Claude Code 进程不一定继承你 shell 里临时设置的环境变量。

5. 第三方模型接入：换掉默认模型

5.1 原理：环境变量切换

Claude Code 默认走 Anthropic 官方接口，但它同样支持通过环境变量把接口地址、认证 token、模型名全部覆盖。这套机制是第三方模型接入的基础。

核心环境变量有三个：

export ANTHROPIC_BASE_URL="https://api.example.com" export ANTHROPIC_AUTH_TOKEN="sk-xxx" export ANTHROPIC_MODEL="your-model-name"

设置之后直接运行claude，它会跳过 Claude 账号登录，用你指定的接口地址和 token 发起请求。只要目标服务端兼容 Anthropic 的 Messages API，就能正常使用。

很多模型服务商，比如 DeepSeek、Qwen、GLM 的开放平台，都开始提供 Anthropic 兼容端点。你只需要去对应控制台找到 “Anthropic API” 或 “Claude Code 接入地址”，把地址填进上面三个变量就行。如果某个服务商只提供 OpenAI 兼容端点，那就需要在中间加一层协议转换，LiteLLM 这类代理工具可以完成这个工作。

注意：用第三方模型时，实际效果好不好取决于模型本身是否擅长“工具调用”。Claude Code 的工作方式不是单纯聊天，它需要模型能理解工具返回结果、决定下一步该执行什么命令。太弱的模型会出现“假装执行成功”或“反复做无用操作”的情况。

5.2 用 CC Switch 管理多供应商

如果你频繁在 DeepSeek、Qwen、GLM 之间切换，手动 export 环境变量非常容易出错。社区里常见的解决方案是 CC Switch，一个小工具，专门用来管理 Claude Code 的多套供应商配置。

CC Switch 的用法很简单：把每个供应商的 Base URL、API Key、模型名保存成一套配置，切换时点一下，它会自动帮你把当前 shell 或配置文件里的环境变量改好。我个人对这类工具的建议是：可以先理解它背后的原理，因为它本质上还是在写环境变量，只是把“手写”变成了“界面化”。

如果你不想依赖第三方工具，也可以在自己的 shell 配置里做几个 alias：

alias claude-deepseek='export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic && export ANTHROPIC_AUTH_TOKEN=sk-deepseek-key && export ANTHROPIC_MODEL=deepseek-chat && claude' alias claude-glm='export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic && export ANTHROPIC_AUTH_TOKEN=sk-glm-key && export ANTHROPIC_MODEL=glm-4.5 && claude'

这样每次切换就是敲一个短命令的事，还避免了配置串台。

5.3 调用 LM Studio 本地模型

调用本地模型是很多人的刚需，尤其是隐私敏感项目、纯离线环境，或者想低成本玩模型切换的场景。LM Studio 是目前比较流行的本地模型运行工具，支持加载 GGUF 格式模型，并提供 OpenAI 兼容的本地接口。

先说结论：Claude Code 默认不直接兼容 OpenAI 的/v1/chat/completions接口，所以如果你想用 LM Studio 跑本地模型，需要在中间加一层协议转换，把 Anthropic 格式翻译成 OpenAI 格式。常见方案是用 LiteLLM Proxy 或类似工具。

步骤大致如下：

1. 在 LM Studio 里加载一个代码模型，比如qwen2.5-coder-7b-instruct。
2. 打开 LM Studio 的 Developer 面板，启动本地服务器，端口默认是 1234。
3. 写一个 LiteLLM 配置文件：

model_list: - model_name: claude-code-local litellm_params: model: openai/qwen2.5-coder-7b-instruct api_base: http://localhost:1234/v1 api_key: lm-studio

4. 启动 LiteLLM 代理：

litellm --config config.yaml --port 4000

5. 配置 Claude Code 使用本地模型：

export ANTHROPIC_BASE_URL=http://localhost:4000 export ANTHROPIC_AUTH_TOKEN=sk-dummy export ANTHROPIC_MODEL=claude-code-local claude

如果你有 NVIDIA 显卡，LM Studio 会自动走 CUDA 加速，不需要额外配置，只要驱动装好就行。本地模型的好处是私有、免费、可控，坏处是模型能力普遍弱于顶级云端模型，复杂项目里的实际完成度会打折扣。拿本地模型做“辅助小任务”很合适，做完整的大型重构会比较吃力。

6. 核心功能实战：从对话到执行终端命令

6.1 第一次启动与基本对话

安装完成后，在项目目录运行claude，你会看到一个交互式输入框。第一次使用建议直接从简单任务开始，比如：

请看一下这个项目的目录结构，告诉我它的技术栈和入口文件在哪里。

Claude Code 会调用终端工具列出文件，读取关键配置文件，然后给出结构化的回答。这个过程中你会注意到它不像普通聊天机器人那样一次性输出长篇内容，而是会显示“正在读取文件”“正在执行命令”这类中间状态，这是因为它真的在操作你的项目。

对话中可以直接用自然语言提要求：

把 src/utils 下的工具函数按功能拆分成多个文件，并更新所有引用。

它会先分析当前代码，制定改动计划，然后逐文件修改。每次改动前，它通常会询问你确认，这是权限机制的一部分。具体表现受你启动时的权限模式影响。

6.2 让 Claude Code 直接执行终端命令

Claude Code 可以直接执行终端命令，这也是它被称为 Agent 而不是聊天机器人的关键原因。

默认情况下，它执行命令前会征求你的确认。比如你说“跑一下测试”，它会先展示要执行的命令：

npm test

你确认后它才运行，然后把输出结果拿回来继续分析。遇到测试失败，它会尝试修复代码，再重新执行测试，形成“失败 -> 修复 -> 重跑”的闭环。

如果你希望它自动执行，不逐个确认，可以启动时加参数：

claude --dangerously-skip-permissions

这个参数的名字已经写得很直白了：跳过权限检查。它适合在容器、CI 环境或你完全清楚项目影响范围的情况下使用。在本地开发时我不推荐长期用它，因为一旦模型理解偏差，它可能会执行你不想执行的破坏性命令。

另一个实用技巧是直接以命令形式调用：

claude "清理 dist 目录里超过 7 天的临时文件"

它会根据你的自然语言指令转换成对应的终端命令并执行。这种方式适合脚本化、定时任务化。

6.3 大型任务的执行模式

处理大型任务时，Claude Code 会拆解步骤，而不是一口气乱来。举个例子，你让它“给这个老项目补上单元测试”，它可能会这么做：

• 先读取现有测试框架配置
• 分析哪些模块有测试覆盖、哪些没有
• 按模块优先级逐个生成测试文件
• 运行测试并修复失败用例
• 最后汇总改动范围和覆盖情况

这个过程可能需要执行几十次命令、读写几十个文件。你不需要每一步都手动干预，但建议保持终端可见，注意看它每一步做了什么。一旦发现方向错误，直接按Esc或Ctrl+C中断，然后补充一句更明确的指令，这比让它一路跑偏再返工效率高得多。

7. 常见问题与排查技巧实录

7.1 组织策略报错

不少公司会统一管理 Claude 订阅。遇到这类报错时，正确做法是联系管理员确认是否放行，而不是自己绕策略去改配置。如果管理员暂时无法开放，你可以走个人账号 + API Key 的方式，但要注意不能违反公司数据安全规定。

7.2 Windows 64 位兼容性问题

有用户反馈过“Claude Code 与 64 位 Windows 不兼容”的弹窗。根据我踩坑的经验，这类问题通常有三个原因：

• 安装的是旧版原生安装包，和当前系统版本不匹配
• 系统缺少运行库，比如 VC++ Redistributable
• 终端环境下没有正确识别 Node.js 路径

解决办法：先卸载旧版本，通过 npm 重新安装最新版；确认 Node.js 是 64 位 LTS；最后在 PowerShell 里跑一次claude --version验证。如果还不行，去 VS Code 扩展设置里检查claude-code.path。

7.3 地区可用性提示

启动时如果看到Claude Code might not be available in your country，说明当前账号或网络环境不在官方支持范围内。我的建议直接一点：去官方文档核对支持地区列表，或者联系官方支持确认。不要使用任何非官方手段绕开限制，那既违规，也容易让账号风控，不值当。

7.4 其他高频问题速查表

8. 扩展玩法与实际体会

8.1 把执行结果推送到飞书群

如果你想让 Claude Code 跑完任务后通知团队，可以把它和飞书群机器人接起来。原理很简单：飞书群里添加一个自定义机器人，复制 Webhook 地址，然后让 Claude Code 在任务结束时调用 webhook 发送消息。

示例如下：

curl -X POST -H "Content-Type: application/json" \ -d '{"msg_type":"text","content":{"text":"Claude Code 已完成任务，请查看结果。"}}' \ https://open.feishu.cn/open-apis/bot/v2/hook/你的机器人地址

你可以直接把这个命令交给 Claude Code 执行，也可以把它写进项目的脚本里。这样团队协作时，AI 助手的执行结果就能自动同步到工作群，省去人工转发。

8.2 我的使用习惯与避坑建议

用了一段时间后，我最大的体会是：Claude Code 强大的前提是项目目录干净、上下文可控。它会把整个项目目录作为上下文，项目里塞满 node_modules、dist、临时文件时，它的判断会被大量无关信息干扰。建议在项目根目录配置忽略文件，限制它扫描的范围。

另外，别把它当搜索引擎用。它是“执行者”，不是“万事通”。问它“这个 API 怎么调”可以，但真正有价值的是让它直接帮你调通 API、处理报错、补完代码。

最后一个小技巧：每次开始大任务前，先让它输出一份计划，确认计划对不对，再让它放手干。这一步能省下大量返工时间。我也习惯把常用的指令组合保存成笔记，比如“代码 review 指令”“测试补全指令”“依赖升级指令”。用熟了之后，你会发现 Claude Code 真正的价值不是替你写代码，而是替你省掉大量“打开文件 -> 理解上下文 -> 改代码 -> 跑测试”的重复循环。