Claude Code 接入

安装运行环境

Claude Code 需要本地 Node.js 环境。开始前先确认 Node.js 版本不低于 18，并保证终端可以正常执行 npm 命令。

• 安装 Node.js 18 或更高版本。
• 在终端运行 node -v 和 npm -v，确认命令可用。
• 如果团队统一配置开发环境，建议把版本要求写进项目说明。

node -v
npm -v

安装 Claude Code

确认运行环境后，通过 npm 安装 Claude Code CLI，并用版本命令确认安装结果。

• 在终端执行全局安装命令。
• 安装完成后检查 claude 命令是否可用。
• 如果安装失败，优先检查 Node.js 版本、npm 源和终端权限。

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

创建 GPTW API Key

进入 GPTW API 控制台创建 API Key，并根据自己的使用强度设置额度上限，避免意外消耗。

• 登录 https://api.pro365.top。
• 进入 API Key 管理页面创建或复制密钥。
• 为密钥设置合理额度上限。
• 保持账户余额充足，避免 Claude Code 使用过程中因余额不足中断。

配置 API Base URL 和 Key

在 Claude Code 或你使用的配置工具中，将 API 地址设置为 GPTW 网关地址，并填入自己的 API Key。

• API Base URL 使用 https://api.pro365.top/v1。
• API Key 使用你在控制台创建的密钥。
• 如果使用 zcf 等辅助配置工具，选择 API 配置入口后填入同样的 URL 和 Key。
• 不要把 API Key 写入公开仓库、截图或聊天记录。

API Base URL: https://api.pro365.top/v1
API Key: 你的 API Key

初始化项目上下文

在项目目录中启动 Claude Code 后，可使用初始化命令生成项目上下文说明，让后续协作更稳定。

• 进入目标项目目录后启动 Claude Code。
• 使用 /init 生成或更新 CLAUDE.md。
• 把项目结构、常用命令、验证方式和禁止事项写进 CLAUDE.md。
• 团队协作时可以补充模块级说明，减少误改范围。

cd your-project
claude
/init

进阶工作流与安全提醒

完成基础配置后，可以逐步接入 MCP、代码审查、日志留痕和成本控制流程，但不要把用户密钥和私有数据暴露给不可信上下文。

• MCP 和工作流配置应按项目需要逐步启用。
• 密钥、支付信息、客户隐私和生产日志不要直接粘贴进公开提示。
• 重要改动前先要求 AI 给计划，改动后要求运行验证命令。
• 定期查看 API 调用记录和余额，发现异常及时停用密钥。