企业官网建设流程全解析

1. 刚装完 Claude Code，第一件事不是写代码而是摸清指令

Claude Code 是 Anthropic 推出的终端 AI 编程助手，能读文件、改代码、跑命令、管 Git，适合习惯在命令行里干活的开发者。但很多人装完之后卡在同一个地方：不知道它到底认哪些指令，敲进去没反应，或者以为要背一大堆命令才能用。其实 Claude Code 的指令体系分两层，一层是启动参数，一层是会话内的斜杠指令，摸清这两层，五分钟就能上手。

我见过最常见的场景是这样的：开发者兴冲冲装好 Claude Code，打开终端敲了个claude，进去之后对着空白的输入框发呆，不知道该说什么。然后试着敲claude /help，结果报错——因为在会话里面不需要再带claude前缀。这类小坑不踩一次很难记住，但踩过之后回头看，整个指令体系其实很清晰。

这篇文章面向刚接触 Claude Code 的开发者，聚焦两件事：一是把指令体系快速过一遍，让你知道有哪些能力可用；二是把本地环境接上 TaoToken 的统一 Key 通道，用/help、/model这些指令验证连通性。配置部分给的是可直接复制的auth.json和settings.json片段，照着填就能跑。指令部分按功能分组，方便你按需查阅，不用一次全记住。

先说清楚一个前提：Claude Code 的指令分「启动命令」和「会话内指令」。启动命令是在终端里敲的，比如claude、claude --help；会话内指令是在 Claude Code 交互界面里敲的，以/开头，比如/help、/model。两者不要混。下面先从环境接入讲起，因为不接通模型，指令敲了也没用。

2. TaoToken 统一 Key 接入 Claude Code 的前置准备

TaoToken 是一个 API 通道服务，提供统一的 Base URL 和 Key，让 Claude Code 这类工具能通过一个入口调用模型。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。你需要先拿到一个 API Key，这个 Key 在控制台的 API Keys 页面生成，地址是 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。

拿到 Key 之后，Claude Code 的接入方式有两种：一种是通过环境变量，一种是通过配置文件。环境变量适合临时测试，配置文件适合长期使用。我建议直接用配置文件，因为 Claude Code 读的是~/.claude/settings.json和~/.claude/auth.json这两个文件，写进去之后每次启动都生效，不用重复设置。

这里要强调一个概念：Claude Code 本身是一个客户端，它需要知道「往哪个地址发请求」和「用什么身份发请求」。Base URL 告诉它地址，API Key 告诉它身份，Model ID 告诉它用哪个模型。这三件套缺一不可。TaoToken 的 Base URL 是https://taotoken.net/api，Key 是你生成的那串字符，Model ID 根据你选的模型填，比如claude-sonnet-4-20250514这类。

如果你之前用过其他工具，可能会习惯在环境变量里写ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。Claude Code 也认这两个变量，但配置文件的方式更稳定，因为环境变量在不同终端会话里可能丢失。下面第三节会给完整的配置文件内容，你直接复制改 Key 就行。

还有一个前置检查：确认你的 Claude Code 版本。在终端敲claude --version，能看到版本号说明安装成功。如果提示 command not found，说明没装好或者没加到 PATH。这一步先过，不然后面配置写了也跑不起来。

3. 可复制的 auth.json 与 settings.json 配置片段

这一节是核心，给的是可直接复制的配置。Claude Code 读取的配置文件在用户目录下的.claude文件夹里，Windows 是C:\Users\你的用户名\.claude\，macOS 和 Linux 是~/.claude/。如果这个文件夹不存在，手动建一个。

第一个文件是auth.json，负责身份认证。内容如下：

{ "apiKey": "你的TaoToken API Key", "baseUrl": "https://taotoken.net/api" }

把你的TaoToken API Key替换成你在控制台生成的那串字符。注意baseUrl后面不要加斜杠，就写到/api为止。这个文件的作用是告诉 Claude Code 往哪里发请求、用什么 Key。

第二个文件是settings.json，负责模型和其他行为配置。内容如下：

{ "model": "claude-sonnet-4-20250514", "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的TaoToken API Key" } }

这里同时写了model字段和env字段。model指定默认使用的模型 ID，env里的两个变量是给 Claude Code 内部调用的兜底配置。有些版本读auth.json，有些版本读env，两个都写上最稳妥。Model ID 可以根据你的需求换，比如想用更快的模型就换对应的 ID，具体可用的 ID 在 TaoToken 的文档页面查，地址是 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

如果你用的是 Claude Code 的 coding plan 模式，配置方式略有不同，需要在启动时指定 plan。Coding Plan 的入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，里面有对应的配置说明。普通使用的话，上面两个文件就够了。

配置写完之后，在终端敲claude启动。如果启动时没有报认证错误，说明配置读到了。接下来就可以用/help验证。这里提醒一句：配置文件的 JSON 格式很严格，多一个逗号少一个引号都会导致解析失败。写完用cat ~/.claude/auth.json看一眼，确认格式没问题。

4. 用 /help 和 /model 验证连通性与指令响应

配置写完，启动 Claude Code，进去之后第一件事是敲/help。这个指令会列出所有可用的会话内指令和简短说明。如果你能看到一长串指令列表，说明客户端本身正常。如果/help没反应或者报错，那可能是启动方式不对，检查是不是在会话里多敲了claude前缀。

/help的输出里会包含指令分类，比如文件操作、执行调试、Git 操作、上下文管理这些。你不用一次全记住，先知道有这些类别就行。接下来敲/status，这个指令显示当前会话状态，包括当前使用的模型、上下文占用情况、连接状态。如果/status里显示的模型 ID 和你配置文件里写的一致，说明配置生效了。

然后敲/model，这个指令用来查看或切换当前模型。直接敲/model会显示当前模型，敲/model 模型ID可以切换。这一步是验证连通性的关键：如果/model能正常显示和切换，说明 Claude Code 已经成功连上了 TaoToken 的通道，请求能发出去也能收回来。

再进一步验证，可以敲一个实际请求，比如/read package.json（前提是你的项目目录下有这个文件）。如果 Claude Code 能读出文件内容并显示，说明整条链路通了：客户端读到配置、请求发到 TaoToken、模型返回结果、客户端展示。到这一步，环境接入就算完成了。

如果你想更直观地验证模型响应，可以打开 TaoToken 的模型对话页面 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，在里面直接发一条消息，看模型是否正常回复。这个页面不依赖本地配置，能帮你区分是「Key 本身有问题」还是「本地配置有问题」。如果网页端能回复、本地不行，那问题就在本地配置文件；如果网页端也不行，那检查 Key 是否有效或额度是否用完。

验证通过之后，你就可以开始用指令干活了。下面把常用指令按功能过一遍，方便你按需查。

启动与退出这块，在终端里敲claude进入交互界面，敲/exit或按 Ctrl+C 退出。进入项目目录再启动，Claude Code 会自动把当前目录作为工作区。

文件操作指令里，/add <file>把文件加入当前会话上下文，/read <file>读取文件内容，/edit <file>用智能 diff 方式编辑，/write <file>写入或覆盖，/patch <file>应用补丁，/delete <file>删除文件。这些指令让你不用离开终端就能操作文件。

执行与调试指令里，/run <command>执行 shell 命令，/test <file>运行测试，/lint做代码规范检查，/format格式化代码。这些指令把常见的开发动作收进了会话里。

Git 操作指令里，/git status、/git add <file>、/git commit -m "message"、/git push、/git pull、/git branch、/git checkout <branch>这些覆盖了日常 Git 流程。你可以在 Claude Code 里直接完成提交和推送，不用切终端。

上下文与记忆指令里，/context查看上下文信息，/save <name>保存上下文，/load <name>加载上下文，/memory save <name>保存会话记忆，/memory load <name>加载记忆，/memory list查看记忆列表，/forget <name>删除记忆，/clear清空当前上下文，/compact压缩上下文。这些指令帮你管理长会话，避免上下文溢出。

代码分析指令里，/sp index构建索引，/sp search <keyword>搜索代码，/sp map <path>生成代码地图，/sp explain <symbol>解释代码逻辑，/sp test <file>生成测试用例。这些指令适合在大型项目里快速定位和理解代码。

三种模式也值得记一下：Ask Before Edits 模式每次修改前询问，Edits Automatically 模式自动修改，Plan Mode 计划模式不做实际修改只探讨方案。新手建议先用 Ask Before Edits，确认 Claude Code 的行为符合预期后再考虑自动模式。

5. 接入过程中常见的报错与排查

配置和验证过程中，最容易碰到几类报错。这一节按报错信息对照排查，你遇到哪个查哪个。

第一类是 401 错误，提示401 Unauthorized或invalid api key。这说明 Key 没被正确读取或 Key 本身无效。排查步骤：先确认auth.json里的apiKey字段填的是完整 Key，没有多余空格；再确认settings.json里env的ANTHROPIC_API_KEY也填了；然后检查 Key 是否在控制台被删除或额度用完。如果网页端模型对话能用，说明 Key 有效，问题在本地配置读取。可以试着把auth.json和settings.json里的 Key 都重新粘贴一遍，注意不要带换行。

第二类是local proxy failed或连接超时。这类报错通常是 Base URL 写错或网络不通。检查baseUrl是不是https://taotoken.net/api，注意不要写成https://taotoken.net/api/（末尾多斜杠），也不要写成其他路径。如果 Base URL 没问题，检查本机网络是否能访问外网。这里不涉及任何网络工具，就是确认基础网络连通性。

第三类是reading choices相关报错，比如error reading choices或返回格式解析失败。这类问题通常是模型 ID 写错，导致服务端返回了非预期格式。检查settings.json里的model字段，确认 Model ID 拼写正确，没有多余字符。Model ID 是区分大小写的，claude-sonnet-4-20250514和Claude-Sonnet-4-20250514可能不一样。去文档页面复制准确的 ID 最稳妥。

第四类是 OAuth 相关报错，比如提示需要登录或OAuth token expired。Claude Code 某些版本会尝试 OAuth 流程，如果你用的是 API Key 方式，需要在配置里明确走 Key 认证。检查settings.json里有没有env字段，把ANTHROPIC_API_KEY写上。如果还是报 OAuth，可以试着删掉~/.claude/下其他认证缓存文件，只保留auth.json和settings.json。

第五类是指令没反应。敲了/help没输出，或者敲了/model没反应。先确认你是在 Claude Code 交互界面里敲的，不是在终端直接敲。终端里敲/help是 shell 的命令，不是 Claude Code 的。进入交互界面后，输入框会有提示符，这时候敲/开头的指令才有效。如果确认在交互界面里还是没反应，检查 Claude Code 版本，旧版本可能不支持某些指令，升级到最新版。

第六类是配置文件格式错误。JSON 解析失败会导致 Claude Code 启动时报错或静默忽略配置。用python -m json.tool ~/.claude/auth.json检查格式，能正常输出说明格式没问题。常见错误包括：末尾多逗号、用了单引号、中文引号、注释。JSON 不支持注释，所有说明文字都要去掉。

排查的时候有个通用思路：先确认网页端模型对话能不能用，能用说明 Key 和通道没问题，问题在本地；不能用说明 Key 或通道有问题，去控制台检查。这个二分法能帮你快速定位问题范围。

6. 指令用熟之后，把 Key 和配置固定下来

指令体系过一遍之后，你会发现常用的其实就那几个：/help查指令，/model切模型，/read读文件，/edit改代码，/git管版本，/compact压上下文。其他的用到再查，不用背。

配置这块，建议把auth.json和settings.json备份一份，换机器或者重装的时候直接复制过去，改一下 Key 就能用。如果你有多个项目，Claude Code 会读当前目录的配置，也可以在项目根目录放一个.claude/settings.json做项目级覆盖，但认证信息还是走用户目录的全局配置。

长期做编码或者跑 Agent 任务的话，可以了解一下 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，里面有适合持续使用的配置方式。API Key 的管理在控制台 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，可以生成多个 Key 分项目使用，方便追踪用量。

最后说一个实际经验：配置写完之后，先用/status确认模型和连接状态，再用/read读一个小文件验证链路，最后再开始正式干活。这三步花不了一分钟，但能避免你在写代码写到一半的时候才发现配置有问题。指令这东西，用多了自然就记住了，关键是先把环境接通，让第一条请求跑通。