1. 第一次打开 Claude Code 终端从装到跑通第一个任务Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手你可以把它理解成一个“住在终端里的工程师”它能读写你本地的文件、执行 shell 命令、调用 Git 和 MCP 工具还能记住你的项目偏好像同事一样跟你协作完成软件工程任务。它不是一个只会聊天的机器人而是一个有手有眼、能真正动手改代码的 Agent。适合谁第一次打开终端、连和/都分不清的开发者以及想把日常重复操作自动化的同学。这篇不讲模型原理、不讲 Prompt 工程只讲工具怎么用。我会从 CLI 安装开始一路带你走完 MCP 接入、Hooks 触发、Subagent 协作最后给出可复制的settings.json配置片段和 TaoToken 统一 Key 的 Base URL 填写示例并用一条命令验证鉴权是否生效。全程按步骤跟做即可不需要提前理解任何底层概念。先明确一个心智模型Claude Code 的交互界面里你打字的地方是输入框底部状态栏显示当前模型、目录和 token 用量上方消息流是对话历史。最常用的两个动作就是直接打字下指令以及用、/、#、!这四个符号调起特殊功能。记住这张表你就赢了一半符号名字用途例子文件引用把文件/目录/资源喂给 ClaudeREADME.md 讲讲这个项目/斜杠命令调起内置命令或技能/help、/review#记忆把内容写入 CLAUDE.md# 用 pnpm 不要 npm!Shell在当前会话执行 shell 命令! git status支持模糊搜索可以一次引用多个文件也能引用整个目录让 Claude 递归看结构比让它自己find/grep更精准、更省 token。/分两类内置命令/help、/clear、/config和项目级技能Skill。#按下去后会问你存到项目级./CLAUDE.md还是全局~/.claude/CLAUDE.md。!则把 shell 输出直接灌进会话上下文适合让 Claude 看到交互式命令的结果。安装 CLI 本身很直接在任意项目目录下执行cd /your/project claude就能进入交互界面。但真正让新手卡住的往往不是安装而是“我该在哪里填 Key、Base URL 写什么、模型 ID 用哪个”。下一节就把这块前置配置讲清楚让你在跑第一个自动化任务之前鉴权链路是通的。2. TaoToken 统一 Key 前置配置Base URL 与模型 ID 怎么填在动手配 MCP 和 Hooks 之前先把鉴权这条链路打通否则后面每一步都会报 401。TaoToken 的作用是给你一个统一的 Key 和 Base URL让你不用在多个模型供应商之间来回切换配置。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。你需要准备三件套Base URL、API Key、Model ID。这三者在任何接入场景里都是绑定的缺一个都跑不起来。Base URL 填https://taotoken.net/apiAPI Key 在控制台的 API Keys 页面生成Model ID 则按你实际要用的模型填写。生成 Key 的入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。如果你用的是 Claude Code 这类 CLI 工具配置通常落在~/.claude/settings.json或项目级.claude/settings.json里。一个最小可用的鉴权配置片段长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }注意ANTHROPIC_BASE_URL后面不要带/v1也不要带任何查询参数保持干净的https://taotoken.net/api即可。Model ID 要和你实际开通的模型一致写错了会报模型不存在。如果你同时用 Codex 或 Cline它们的配置文件位置不同但三件套的填法逻辑是一样的Base URL 指向 TaoTokenKey 用同一个Model ID 按需选。配置完成后别急着往下走先验证鉴权是否生效。最直接的方式是用一条 curl 命令打一次模型对话接口curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 只回复两个字通了}] }如果返回里能看到content字段且内容是“通了”说明 Base URL、Key、Model ID 三件套全部正确。如果返回 401先检查 Key 有没有复制完整、有没有多余空格如果返回模型不存在检查 Model ID 拼写。这一步过了后面的 MCP、Hooks、Subagent 才有意义。你也可以直接在模型对话页面手动发一条消息做交叉验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。3. 可复制配置settings.json 里接 MCP、Hooks 与权限鉴权通了之后接下来把 MCP、Hooks 和权限规则写进settings.json。这个文件按优先级从高到低有三个位置项目级.claude/settings.local.json个人本地不进 git、项目级.claude/settings.json团队共享进 git、全局~/.claude/settings.json。新手建议先改全局跑通后再往项目级下沉。先看 MCP 接入。MCP 是让 Claude 调用外部服务的协议配置后 Claude 会自动获得新工具命名格式是mcp__server__tool。下面这段配置同时包含了鉴权环境变量、MCP Server 和权限规则可以直接复制后改 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /your/project] } }, permissions: { allow: [ Bash(npm test:*), Bash(git status), Bash(git diff:*), Read(*), Edit(src/**) ], deny: [ Bash(rm -rf:*), Bash(git push --force:*) ] }, hooks: { PostToolUse: [ { matcher: Edit|Write, hooks: [ { type: command, command: npx prettier --write $CLAUDE_FILE_PATH } ] } ], Stop: [ { hooks: [ { type: command, command: echo 任务结束 } ] } ] } }这里有几个关键点。mcpServers里的command和args要按你实际要接的服务改filesystem只是示例。permissions.allow里用Bash(npm test:*)这种写法做前缀匹配Edit(src/**)限定只能改 src 目录。hooks里的PostToolUse匹配Edit|Write意思是每次 Claude 改完文件就自动跑 prettier 格式化Stop钩子在 Claude 结束响应时触发你可以换成系统提示音或通知脚本。Hooks 有一个必须记住的原则它是自动行为的唯一实现方式。你写在 memory 里的“以后每次都 X”不会主动触发因为 Claude 不会回头检查记忆。只有 Hooks 能在特定事件发生时由 harness 自动执行命令。常见事件有PreToolUse、PostToolUse、UserPromptSubmit、Stop、SessionStart、SessionEnd。权限模式也要心里有数default每次新工具都问acceptEdits自动允许文件编辑bypassPermissions全自动但危险plan进入计划模式。切换用/permissions或ShiftTab。如果你嫌弹窗烦可以用/fewer-permission-prompts技能自动扫描对话历史把常用只读命令加进 allowlist。配置改完后重启会话或/clear刷新让新配置生效。4. 验证请求一条命令确认 MCP 与 Hooks 真的生效配置写完不代表生效必须验证。先验证 MCP在 Claude Code 里输入/mcp应该能看到你配置的 server 列表和它暴露的工具。如果列表为空说明settings.json没被加载检查文件路径和 JSON 语法少个逗号就会静默失败。验证通过后你可以直接让 Claude 调用 MCP 工具比如“用 filesystem 列出项目根目录”看它是否返回真实文件列表。再验证 Hooks。最直观的方式是让 Claude 改一个文件然后观察PostToolUse是否触发。你可以故意在src下建一个格式混乱的.ts文件然后对 Claude 说“把 src/xxx.ts 里的变量名改成驼峰”改完后检查文件是否被 prettier 自动格式化。如果没触发检查matcher是否写对、$CLAUDE_FILE_PATH是否被正确替换。Stop钩子更容易验证随便问一句看响应结束后有没有执行你配的命令。验证 Subagent 也很简单。输入/agents查看可用子代理常见的有Explore只读搜索、general-purpose复杂多步任务、Plan架构方案。你可以显式要求“用 Explore agent 帮我找下哪里在用 Redis”观察它是否分发到独立实例执行。Subagent 的价值在于并行和上下文隔离重活丢给它主对话不被污染。最后做一次端到端验证让 Claude 在后台启动一个 dev server同时在前台让它读 README 并总结。如果后台任务不阻塞主对话且/tasks能看到任务列表说明后台执行链路正常。跑完这一轮你的 Claude Code 就算真正跑通了第一个自动化任务。想进一步验证模型响应质量可以去模型对话页面手动对比https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。5. 常见报错排查401、local proxy failed、reading choices、OAuth新手最容易撞上的就是鉴权类报错。401 Unauthorized基本是 Key 问题复制时带了空格、Key 已失效、或者ANTHROPIC_API_KEY没写进env而是写在了别处。排查顺序是先确认 Key 在控制台有效再用第 2 节那条 curl 命令单独测curl 通了说明 Key 没问题问题在 Claude Code 的配置加载。local proxy failed通常出现在你本地起了代理或端口冲突时。先检查ANTHROPIC_BASE_URL是不是被改成了localhost或某个本地端口正确值应该是https://taotoken.net/api。如果你之前配过其他工具的代理环境变量检查HTTP_PROXY、HTTPS_PROXY有没有残留它们会干扰请求走向。reading choices这类报错多半是响应结构不符合预期常见于 Model ID 写错或 Base URL 多带了/v1。Claude Code 期望的是 Anthropic 风格的响应如果你把 Base URL 写成https://taotoken.net/api/v1路径就会重复。把 Base URL 改回https://taotoken.net/apiModel ID 确认拼写正确一般就能解决。OAuth相关报错出现在你用账号登录而非 Key 鉴权的场景。如果你走的是 Key 模式确保没有同时启用 OAuth 登录态两者会打架。清理~/.claude下的登录缓存只保留env里的 Key 配置。另外如果你在 Cline、CC Switch 或 Codex 里也配了同一套记得三件套Base URL Key Model ID在每个工具里都要写全缺一个就会报鉴权失败。还有一类非报错但很烦的问题Claude 改了一堆你没让它改的东西。解法是在CLAUDE.md里写“只做我明确要求的不要顺手重构”或者用 Plan Mode 让它先报方案再动手。上下文爆了导致遗忘用/compact压缩或/clear重开关键信息先存进CLAUDE.md。斜杠命令列表里没有你装的技能检查 skill 文件是否在.claude/skills/*.md或~/.claude/skills/*.md以及 frontmatter 的name字段是否正确。6. 长期编码与 Agent 协作把 Coding Plan 用起来当你已经能稳定跑通单次任务下一步就是把它变成日常编码的长期搭档。这里的关键是理解 Plan Mode、TodoList 和 Subagent 的配合。Plan Mode 让 Claude 先探索代码、提出方案、等你批准再动手适合不确定的实现TodoList 自动跟踪多步骤任务进度你可以中途打断调整Subagent 则把重活外包出去用独立实例并行执行不污染主对话上下文。一个典型的长任务工作流是这样的先让 Claude 在后台启动 dev server再让它跑全量测试两者都不阻塞主对话然后你在前台让它读 README 并写文档测试跑完后 Claude 主动通知你结果。这种并行能力是 Claude Code 区别于普通聊天工具的核心。如果你要跑定时任务可以用/loop 5m 检查下 dev.log 有没有新的 ERROR它会每 5 分钟自动执行一次。对于需要长期、稳定、高频使用的场景建议走 Coding Plan把额度、模型和并发都规划好避免临时抓瞎https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档里有各工具的完整配置示例遇到不确定的字段可以直接对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你用 Claude Code 的 Anthropic 兼容模式专门的接入说明在这里https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后给一个我实测下来最省心的习惯把项目约定、测试命令、commit 规范全部写进CLAUDE.md把自动格式化、通知这类行为全部交给 Hooks把重活分发给 Subagent长任务丢后台。这样你的主对话始终干净Claude 也不会因为上下文太满而遗忘。工具本身不复杂难的是把这几块拼成一套顺手的流程跑通一次之后后面就是复制粘贴的事了。