Claude Code 是一款运行在终端中的 AI 编程工具，可以通过灵活的自然语言辅助开发者高效编码、调试和管理代码。本文以 Hy3 preview 模型为例演示如何将模型接入到 Claude Code 中使用。
安装 Claude Code
如果您已安装 Claude Code ，可以跳过这一步。
前置条件
安装 Claude Code 依赖以下前置条件：
安装 Node.js 18 或更高版本。
Windows 用户需额外安装 Git for Windows。
1. 准备 Node.js 环境（v18.0 或更高版本）
MacOS/Linux
# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash# 将下面的激活 nvm 脚本添加到~/.bashrc或者 ~/.zshrc，根据你使用的shell决定。一般情况下，上面安装 nvm 的脚本会自动完成这一步，如果没有，可以手动添加export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"[ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh"# 如果你用的是 bashsource ~/.bashrc# 如果你用的是 zshsource ~/.zshrc# 使用 nvm 安装 nodejs 20nvm install 20# 设置默认 nodejs 版本nvm alias default 20# 设置nodejs 版本nvm use 20
Windows
请按以下步骤手动安装 Node.js：
1. 访问 Node.js 官方下载页，下载 安装包。
2. 双击安装包，按指引完成安装。
3. 在命令行中执行以下命令验证：
# 验证 Node.js 版本node -v # Should print "v20.20.0".# 验证 npm 版本npm -v # Should print "10.8.2".
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装完成后查看版本，正常显示版本号即为成功：
claude --version
获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：
在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 Hy3 preview。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
配置 Claude Code
1. 手动配置模型的环境变量
完成 Claude Code 安装和 API Key 的获取后，需要配置 Hy3 preview 模型的 API 信息，具体配置方式如下：
编辑或新增
settings.json 文件，并根据您获取 API Key 的渠道，增加对应的配置文件内容，不同系统的配置文件路径不同，具体可参考：MacOS/Linux 对应路径为
~/.claude/settings.jsonWindows 对应路径为
用户目录/.claude/settings.json若
settings.json 文件不存在，可使用文本编辑器（如 VSCode、记事本等）手动创建，或在终端中执行以下命令创建：# MacOS/Linuxmkdir -p ~/.claude && touch ~/.claude/settings.json# Windows（PowerShell）New-Item -ItemType Directory -Force -Path "$HOME\\.claude" | Out-Null; New-Item -ItemType File -Force -Path "$HOME\\.claude\\settings.json" | Out-Null
配置以下内容（注意将
YOUR_API_KEY 替换为真实 API Key）：{"env": {"ANTHROPIC_BASE_URL": "https://tokenhub.tencentmaas.com","ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY","ANTHROPIC_MODEL": "hy3-preview","ANTHROPIC_DEFAULT_OPUS_MODEL": "hy3-preview","ANTHROPIC_DEFAULT_SONNET_MODEL": "hy3-preview","ANTHROPIC_DEFAULT_HAIKU_MODEL": "hy3-preview","CLAUDE_CODE_SUBAGENT_MODEL": "hy3-preview","ENABLE_TOOL_SEARCH": false}}
保存配置后，请打开新的终端窗口执行后续命令，确保环境变量加载生效。
2. 确认环境变量是否生效
进入命令行界面，执行以下命令启动 Claude Code：
# 打开项目目录cd your-project# 启动 Claude Codeclaude
注意：
若您是首次启动 Claude Code，终端会先进入交互式初始化向导，依次提示您选择主题（Theme）、登录方式（Login Method）等。请按照终端提示完成首次配置后再继续后续步骤。
启动成功后，在 Claude Code 中输入
/status 确认模型状态生效（参考下图示例）：当 API Endpoint 显示为 https://tokenhub.tencentmaas.com，且 Model 显示为 hy3-preview 时，即表示模型配置已生效。
3. 使用 Claude Code
确认配置生效后，即可开始对话：
注意：
1. 基于以上配置，Hy3 preview 默认思考模式为
no_think，如需开启深度推理，请参考本文档的 开启深度推理 小节进行设置。2. Claude Code 禁止第三方模型使用内置原生搜索工具，若您需要结合搜索使用，可在 腾讯云 MCP 市场 等渠道选用合适的 MCP 服务使用，详情请参见 常见问题。
4. 开启深度推理
若需要开启深度推理（high），则需要在 Claude Code 中输入
/config，将 Thinking mode 设置为 true。
确认设置后，退出重新进入 Claude Code，即可生效。
常见问题
配置模型后为何无法在 Claude Code 中使用搜索（web search）？
Claude Code 禁止第三方模型使用内置原生搜索工具，因此在配置 Hy3 preview 模型后，将无法正常使用 Claude Code 原生的 web search 工具，此时若使用中触发搜索，会出现如下图搜索失败的表现：
步骤2：开通服务后，页面上会显示连接搜索服务的配置 json，点击复制配置内容。
步骤3：在 Claude Code 中，执行以下命令添加 MCP（注意将“XXX”替换为您获取的真实值）。
claude mcp add --transport sse WebSearchMCP "https://mcp-api.tencent-cloud.com/sse/XXX"
步骤4：执行以下命令启动 Claude Code（启动时，推荐通过 disallowedTools "WebSearch" 关闭原生搜索工具，可确保模型更稳定的调用您配置的搜索 MCP 服务）。
claude --disallowedTools "WebSearch"
步骤5：MCP 配置完成后，需重启 Claude Code 才能生效。请退出当前 Claude Code 会话（输入
/exit 或按 Ctrl+C 退出），再重新执行上述启动命令。重启后，即可在 Claude Code 中通过您配置的搜索 MCP 服务正常使用搜索能力。
