Claude Code API 接入指南

快速开始

学习如何注册账号并开始使用米醋API平台

第一步：注册账号

访问注册页面 https://api.micu.wiki/register

使用邮箱注册

填写注册信息：

邮箱地址：用于接收验证邮件和重要通知
用户名：设置您的账号用户名
密码：设置安全密码（建议使用字母、数字和特殊字符组合）

填写完成后，点击提交完成注册。

提示

请妥善保管您的登录凭证，避免账号被盗用。

访问登录页面 https://api.micu.wiki/login

输入您的邮箱地址或用户名
输入密码
点击登录按钮

第三步：创建 API 令牌

登录成功后，您需要创建 API 令牌（Token）才能调用米醋API服务。

进入令牌管理页面

登录后进入控制台主页
在左侧菜单或顶部导航找到 "令牌" 或 "API 密钥" 选项
点击进入令牌管理页面

创建新令牌

点击 "新建令牌" 或 "创建 Token" 按钮，填写令牌信息：

令牌名称：为令牌设置一个易于识别的名称（如：生产环境、测试项目等）
分组选择：选择VIP分组（务必选择VIP分组以保障您的权益）
过期时间（可选）：设置令牌的有效期，不设置则永久有效
额度限制（可选）：限制该令牌的最大调用额度
模型权限（可选）：选择该令牌可以访问的模型

点击 "提交" 或 "创建" 完成令牌创建。

重要提示

令牌创建后只会显示一次，请立即复制保存到安全的地方。如果丢失，需要重新创建新令牌。

分组务必选择VIP分组以保障您的权益。

下一步

完成以上步骤后，您就可以开始使用米醋API了。请在左侧选择您的操作系统平台，查看详细的 Claude Code 安装和配置教程。

系统要求

Windows 10 或更高版本

安装 Claude Code

前置条件

Claude Code 必须安装 NodeJS 18+ 环境（可在终端执行 node -v 检测是否已安装），如果已安装，请跳过本节。

访问官网 https://nodejs.org/zh-cn/download
根据自己的系统选择对应的下载安装包：

安装步骤

1. 安装 Claude Code

Shell

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

2. 验证安装

Shell

claude --version

正常情况应该输出类似于：1.0.108 (Claude Code)

配置环境变量

使用 cc-switch 配置（推荐）

下载地址：farion1231/cc-switch - 一个用于管理和切换 Claude Code 和 Codex 配置及 MCP 服务器的跨平台桌面应用

命令行配置

PowerShell配置（请注意将 sk-xxx 替换为你自己的专属 key！）

PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.micu.wiki", "User")

CMD配置（请注意将 sk-xxx 替换为你自己的专属 key！）

CMD

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.micu.wiki"

提示

设置好后，重启终端以让环境变量生效。

启动 Claude

在终端，进入（cd 目录）到项目目录或在任意目录，输入命令 claude 即可启动使用。

系统要求

MacOS 10.15 (Catalina) 或更高版本

安装步骤

1. 安装 Claude Code

Shell

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

2. 验证安装

Shell

claude -v

正常情况应该输出类似于：1.0.108 (Claude Code)

配置环境变量（请注意将 sk-xxx 替换为你自己的专属 key！）

Bash

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.micu.wiki"' >> ~/.bash_profile
source ~/.bash_profile

提示

配置完成后，重启终端以让环境变量生效。

启动 Claude

在终端，进入（cd 目录）到项目目录或在任意目录，输入命令 claude 即可启动使用。

系统要求

Linux发行版 (Ubuntu 18.04+, CentOS 7+, Debian 9+等)

安装步骤

1. 安装 Claude Code

Shell

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

2. 验证安装

Shell

claude -v

正常情况应该输出类似于：1.0.108 (Claude Code)

配置环境变量

Ubuntu/Debian（Bash）

请注意将 sk-xxx 替换为你自己的专属 key！

Bash

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.micu.wiki"' >> ~/.bash_profile
source ~/.bash_profile

Fedora/CentOS（Zsh）

请注意将 sk-xxx 替换为你自己的专属 key！

Zsh

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.micu.wiki"' >> ~/.zshrc
source ~/.zshrc

提示

配置完成后，重启终端以让环境变量生效。

启动 Claude

在终端，进入（cd 目录）到项目目录或在任意目录，输入命令 claude 即可启动使用。

我是如何使用 Claude Code 每一项功能的

作为一名 Claude Code 的狂热爱好者，我每周都会在虚拟机里运行几次，处理个人项目。在连续几个月坚持使用 Claude Code之后，这篇文章总结了我对其整个生态系统的思考。

提示

这篇文章篇幅较长，建议把它当作参考手册，而不是一次性读完。

CLAUDE.md

在代码库里，要想高效使用 Claude Code，最重要的文件就是根目录下的 CLAUDE.md。它是 Agent 的行为准则，是了解你这仓库运作方式的首要依据。

技巧与常见反模式

随着时间推移，我们形成了一套鲜明且有主见的写作哲学，来打造高效的 CLAUDE.md。

先设限制，而不是写指南。你的 CLAUDE.md 应从小处着手，根据 Claude 常犯的错误来逐步记录相关内容。
别在 CLAUDE.md 里到处 @ 引用文档。如果你只是在文中提到路径，Claude 通常会忽略它。相反的，你必须向 Agent 推销"为什么"以及"什么时候"需要读这份文件。
不要只说"禁止"。避免纯粹的负面约束。当 Agent 认为它必须使用该标志时，就会左右脑互博，导致卡住。所以永远要提供可行的替代方案。
把 CLAUDE.md 当成强制性手段。保持 CLAUDE.md 尽可能短，是迫使你精简代码库和内部工具的绝佳手段。

核心要点

把 CLAUDE.md 当作一套高层次、精心策划的护栏和指引。用它来指导你在哪里需要投入更多精力来打造对 AI（和人类）更友好的工具。

上下文管理之压缩和清理

我建议在编码会话中至少运行一次 /context，来了解你那 200k token 的上下文窗口是如何被使用的。

三个主要的工作流程：

/compact (避免使用) - 我尽可能避免使用这个命令。它的自动压缩过程不透明、容易出错，而且优化得不好。
/clear + /catchup (简单重启) - 这是我的默认重启方式。我用 /clear 清除状态，然后运行一个自定义的 /catchup 命令。
"记录并清除" (复杂重启) - 用于大型任务。我让 Claude 把它的计划和进展输出到一个 .md 文件中，然后用 /clear 清除上下文。

核心要点

不要相信自动压缩。对简单的重启使用 /clear，对复杂任务使用"记录并清除"的方法来创建持久的外部"记忆"。

自定义斜杠命令

我把斜杠命令看作是常用提示的简单快捷方式，仅此而已。我的配置非常精简：

/catchup: 提示 Claude 读取我当前 git 分支中所有已更改的文件。
/pr: 一个简单的辅助工具，用来清理我的代码、暂存更改，并准备一个 Pull Request。

核心要点

把斜杠命令当作简单、个人化的快捷方式，而不是用它来替代构建更直观的 CLAUDE.md 和更好的工具化 Agent。

自定义 SubAgent

理论上，SubAgent 是 Claude Code 在上下文管理方面最强大的功能。但我发现，SubAgent 会带来两个新问题：

它们把上下文"关起来"了 - 主 Agent 再也无法对一个变更进行整体性的思考。
它们强迫 Agent 遵循人类的工作流 - 强迫 Claude 进入一个僵硬的、由人类定义的工作流。

我更喜欢的替代方案是使用 Claude 内置的 Task(...) 功能来生成通用代理的克隆体。我把所有关键上下文都放在 CLAUDE.md 里，然后让主 Agent 自己决定何时以及如何将工作委派给它自己的副本。

核心要点

自定义 SubAgent 是一个脆弱的解决方案。把上下文给你的主 Agent（放在 CLAUDE.md 里），让它使用自己的 Task/Explore(...) 功能来管理任务委派。

钩子 (Hooks)

钩子非常重要。它们对于在一个复杂的企业级代码库中引导 Claude 至关重要。它们是确定性的"必须做"的规则，与 CLAUDE.md 中的"应该做"的建议互为补充。

两种类型的钩子：

提交时阻断钩子 (Block-at-Submit Hooks) - 主要策略。在提交阶段检查最终的、完整的结果。
提示钩子 (Hint Hooks) - 简单的、非阻塞的钩子，提供"即发即忘"式的反馈。

我们刻意不使用"写入时阻断"的钩子。在 Agent 执行计划中途阻断它，会使它困惑甚至"沮丧"。更有效的方法是让它完成它的工作，然后在提交阶段检查。

核心要点

使用钩子在提交时强制执行状态验证。避免在写入时阻断——让 Agent 完成它的计划，然后再检查最终结果。

Plan 模式

对于任何使用 AI IDE 进行的"大型"功能变更，规划都是必不可少的。

对于个人项目，使用内置的 Plan 模式。这是一种在 Claude 开始工作前与它对齐的方式，既定义了如何构建某样东西，也定义了它需要停下来向我展示工作的"检查点"。

核心要点

对于复杂的变更，总是使用内置的 Plan 模式，在 Agent 开始工作前先就计划达成一致。

技能 (Skills)

Skills（也许）比 MCP 更重要。我对 Agent 自主性的心智模型已经演变为三个阶段：

单次提示 (Single Prompt)：在一个巨大的提示中给 Agent 所有上下文。（脆弱，无法扩展）。
工具调用 (Tool Calling)："经典"的 Agent 模型。我们手动制作工具。（更好，但创造了新的抽象和上下文瓶颈）。
脚本化 (Scripting)：我们给 Agent 访问原始环境的权限，然后它动态地编写代码来与它们交互。

基于这个模型，Agent Skills 显然是下一个重要功能。它们是"脚本化"这一层的正式产品化。SKILL.md 文件是一个更有组织、可共享、可发现的方式来记录这些 CLI 和脚本。

核心要点

Skills 是正确的抽象。它们将基于"脚本化"的智能体模型正式化，这种模型比 MCP 所代表的僵硬的、类似 API 的模型更健壮、更灵活。

模型上下文协议 (MCP)

Skills 并不意味着 MCP 已死。"脚本化"模型（现在由 Skills 正式化）更好，但它需要一个安全的方式来访问环境。对我来说，这正是 MCP 新的、更专注的角色。

一个 MCP 不应该是一个臃肿的 API，而应该是一个简单、安全的网关，提供几个强大的、高层次的工具。

核心要点

使用扮演数据网关角色的 MCP。给智能体一两个高层次的工具，然后让它基于这些工具编写脚本。

Claude Code (Agent) SDK

Claude Code 不仅仅是一个交互式的 CLI；它也是一个强大的 SDK。对于大多数新的个人项目，我已经开始用它作为我的默认 Agent 框架。

主要在三个方面使用它：

大规模并行脚本 - 对于大规模重构、bug 修复或迁移，编写简单的 bash 脚本并行调用。
构建内部聊天工具 - 将复杂的流程包装成一个简单的聊天界面，供非技术用户使用。
快速 Agent 原型设计 - 最常见的用法，在选择更复杂的框架之前快速原型化新的 Agent。

核心要点

Claude Agent SDK 是一个强大的、通用的 Agent 框架。用它来批量处理代码、构建内部工具，以及在选择更复杂的框架之前快速原型化新的 Agent。

Claude Code GHA (GitHub Action)

Claude Code GitHub Action (GHA) 可能是我最喜欢也是最被低估的功能之一。它的概念很简单：就是在 GHA 中运行 Claude Code。但正是这种简单性使其如此强大。

你控制整个容器和环境，这让你能接触到更多数据，并且至关重要的是，比任何其他产品提供更强的沙盒和审计控制。此外，它支持所有高级功能，如 Hooks 和 MCP。

核心要点

GHA 是将 Claude Code 投入生产运营的终极方式。它将其从个人工具转变为你工程系统中一个核心的、可审计的、自我改进的部分。

settings.json

最后，我有一些特定的 settings.json 配置，我发现在个人和专业工作中都至关重要。

HTTPS_PROXY/HTTP_PROXY: 这对调试非常有用。
MCP_TOOL_TIMEOUT/BASH_MAX_TIMEOUT_MS: 我调高了这些值。
ANTHROPIC_API_KEY: 使用企业 API 密钥。
permissions: 偶尔自我审计一下允许 Claude 自动运行的命令列表。

核心要点

你的 settings.json 是进行高级定制的强大工具。

结语

内容很多，但希望对你有用。如果你还没有开始使用像 Claude Code 这样的基于命令行的 Code Agent，你或许应该开始了。这些高级功能很少有好的指南，所以学习的唯一方法就是亲身投入进去。

文章来源

本文内容引用自哈雷彗星（Haleclipse）在 Linux.do 社区发布的文章。

原文链接：《我是如何使用 Claude Code 每一项功能的》

Claude Code API 接入指南

快速开始

第一步：注册账号

使用邮箱注册

提示

第二步：登录账号

使用邮箱/用户名登录

第三步：创建 API 令牌

进入令牌管理页面

创建新令牌

重要提示

下一步

系统要求

安装 Claude Code

前置条件

安装步骤

配置环境变量

使用 cc-switch 配置（推荐）

命令行配置

提示

启动 Claude

系统要求

安装步骤

配置环境变量（请注意将 sk-xxx 替换为你自己的专属 key！）

提示

启动 Claude

系统要求

安装步骤

配置环境变量

Ubuntu/Debian（Bash）

Fedora/CentOS（Zsh）

提示

启动 Claude

我是如何使用 Claude Code 每一项功能的

提示

CLAUDE.md

技巧与常见反模式

核心要点

上下文管理之压缩和清理

核心要点

自定义斜杠命令

核心要点

自定义 SubAgent

核心要点

钩子 (Hooks)

核心要点

Plan 模式

核心要点

技能 (Skills)

核心要点

模型上下文协议 (MCP)

核心要点

Claude Code (Agent) SDK

核心要点

Claude Code GHA (GitHub Action)

核心要点

settings.json

核心要点

结语

文章来源