Skip to content

dunerbing/AI-Dev-Kit

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
examples
examples
 
 
CHANGELOG.md
CHANGELOG.md
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
ai-dev-kit.ps1
ai-dev-kit.ps1
 
 

Repository files navigation

AI-Dev-Kit

AI-Dev-Kit 是一个面向 Windows 新手用户的 Claude / Codex 编程环境一键配置工具。它用中文菜单帮助你检查电脑环境、安装基础工具、安装 Claude Code 和 OpenAI Codex CLI，并配置 Claude Code 常见的 API 接入方式。

当前版本优先提供 PowerShell 脚本，不包含 GUI。

适合谁使用

  • 想在 Windows 10 / Windows 11 上使用 Claude Code 或 Codex CLI 的新手。
  • 不熟悉 Git、Node.js、Python、VS Code 安装流程的用户。
  • 需要在 Claude Code 中切换 Anthropic 官方 API、DeepSeek 兼容 API、账号登录模式的用户。

不适合谁使用

  • 想破解 Claude、绕过订阅、伪造授权的用户。
  • 想在 Linux/macOS 上配置环境的用户。
  • 需要复杂企业代理、统一设备管理、集中密钥托管的团队。

使用前准备

建议先准备：

  1. 一台 Windows 10 或 Windows 11 电脑。
  2. 可以访问互联网的网络。
  3. PowerShell 或 Windows Terminal。
  4. 如果要使用 API 模式，请提前准备自己的 Anthropic API Key 或 DeepSeek API Key。

注意：Claude Pro/Max 订阅和 Anthropic API Key 不是一回事。Pro/Max 是 Claude 账号订阅，API Key 是开发者 API 计费方式。

如何运行

在项目目录中打开 PowerShell，然后运行：

.\ai-dev-kit.ps1

如果系统提示禁止运行脚本，可以在当前 PowerShell 窗口临时放行本次运行：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\ai-dev-kit.ps1

这个命令只影响当前窗口，关闭窗口后会恢复。

其他设备如何使用

把整个项目文件夹复制到另一台 Windows 电脑即可使用。最少需要带上这些文件：

ai-dev-kit.ps1
README.md
SECURITY.md
CHANGELOG.md
examples/

复制过去后，在那台电脑上打开 PowerShell，进入文件夹，再运行：

.\ai-dev-kit.ps1

请注意：

  • 每台电脑都要单独安装 Git、Node.js、Claude Code、Codex CLI 等工具。
  • 每台电脑都要单独配置自己的 API Key，除非你使用的是自己搭建的局域网 API 网关。
  • 不建议把包含真实 API Key 的截图、命令记录、配置文件发给别人。
  • 如果你用 U 盘或压缩包分发，只分发这个工具本身，不要把自己的 API Key 一起发出去。

如果你在一台电脑上运行了 LiteLLM 或其他 Anthropic-compatible API 网关，其他设备可以通过局域网 IP 和端口连接它。例如网关电脑的 IP 是 192.168.1.23，端口是 4000，其他电脑可以在菜单 12 中配置：

协议：http
地址：192.168.1.23
端口：4000
路径：按你的网关要求填写，可留空或填写 /anthropic

如果跨设备连接失败，通常要检查三件事：两台电脑是否在同一个局域网或 VPN、网关服务是否监听了局域网地址、防火墙是否放行了对应端口。

菜单功能说明

1. 一键安装基础工具

检查并安装 Git、Node.js LTS、Python 3、Visual Studio Code，并可选安装 uv。Windows 下优先使用 winget。

2. 安装 Claude Code

检测 claude 命令。如果没有安装，会使用 Anthropic 官方 Windows PowerShell 安装命令。

3. 安装 Codex CLI

检测 codex 命令。如果没有安装，会优先使用 OpenAI 官方 Windows PowerShell 安装命令；失败时可选择 npm 方式安装 @openai/codex。

4. 配置 Anthropic 官方 API

隐藏输入 Anthropic API Key，保存到用户级环境变量 ANTHROPIC_API_KEY，并清除 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。

5. 配置 DeepSeek 接入 Claude Code

隐藏输入 DeepSeek API Key，设置：

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_API_KEY=你的 DeepSeek API Key

还可以选择是否设置 ANTHROPIC_MODEL。

6. 清除 Claude API 配置，恢复账号登录模式

清除用户级环境变量：

ANTHROPIC_API_KEY
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_MODEL

7. 检查当前环境

显示 Git、Node.js、npm、Python、VS Code、Claude Code、Codex CLI 是否安装，并显示 Claude API 配置状态。不会显示完整 API Key。

8. 启动 Claude Code

检测到 claude 后直接运行 Claude Code。

9. 启动 Codex

检测到 codex 后直接运行 Codex CLI。

10. 查看 Claude API 当前配置状态

判断当前可能是 Anthropic 官方 API 模式、DeepSeek API 模式、自定义网关模式，还是 Claude 账号登录模式。

11. 打开项目说明

尝试打开本 README 文件。

12. 配置自定义 API 网关（可输入端口）

适合 LiteLLM、本机代理、局域网代理、公司内部网关等 Anthropic-compatible API 场景。可以直接粘贴完整 Base URL，也可以让工具分步询问协议、地址、端口和接口路径。

账号登录模式和 API 模式的区别

Claude 账号登录模式：运行 claude 后，通过浏览器登录 Claude 账号。是否可用取决于你的 Claude 账号和套餐。

API 模式：通过环境变量提供 API Key。Claude Code 会优先读取这些环境变量，并把请求发到对应 API。API 用量通常按 API 计费，不等同于 Claude Pro/Max 订阅。

Anthropic 官方 API 和 DeepSeek 接入的区别

Anthropic 官方 API：请求发往 Anthropic API，使用 Anthropic 的模型和计费。

DeepSeek 接入：请求发往 DeepSeek 提供的 Anthropic-compatible API。它只是接口兼容，不等于使用 Claude 模型，也不等于 Anthropic 官方服务。

自定义网关：请求发往你自己指定的 Base URL，例如本机的 http://127.0.0.1:4000，或局域网内另一台电脑的 http://192.168.1.23:4000。具体使用哪个模型、怎么计费、需要什么密钥，取决于你的网关设置。

常见问题

为什么输入 API 后 Claude 还是不能用？

最常见原因是当前终端没有刷新环境变量。请关闭 PowerShell，重新打开后再运行 claude。也可能是 API Key 无效、账户余额不足、网络无法访问对应 API，或模型名设置不正确。

为什么提示找不到 claude？

说明 Claude Code 没有安装成功，或者刚安装完但 PATH 没刷新。请重新打开 PowerShell，运行菜单 7 检查；仍不行就运行菜单 2 重新安装。

为什么找不到 codex？

说明 Codex CLI 没有安装成功，或者 PATH 没刷新。请重新打开 PowerShell，运行菜单 7 检查；仍不行就运行菜单 3 重新安装。

为什么安装 Git/Node 失败？

常见原因包括没有 winget、Microsoft Store 的“应用安装程序 App Installer”太旧、网络不稳定、权限不足、公司/校园网络拦截。可以先更新 App Installer，再重试菜单 1。

为什么需要重新打开终端？

Windows 环境变量变化后，已经打开的终端通常不会自动刷新。重新打开 PowerShell 后，新环境变量和 PATH 才会生效。

Claude Pro/Max 和 API Key 是不是一回事？

不是。Claude Pro/Max 是 Claude 账号订阅。API Key 是开发者 API 使用凭据，通常单独按 API 用量计费。

DeepSeek 接入 Claude Code 是否等于使用 Claude 模型？

不是。DeepSeek 接入表示 Claude Code 请求 DeepSeek 的兼容接口，实际使用的模型和计费以 DeepSeek 为准。

其他电脑怎么使用同一个本地 API 网关？

先在网关所在电脑上启动你的 API 网关，并确认它允许局域网访问。然后在其他电脑运行本工具，选择菜单 12，输入网关电脑的局域网 IP 和端口。不要把这个端口直接暴露到公网。

卸载和清理

清除 Claude API 配置：运行脚本菜单 6。

卸载 Claude Code、Codex CLI、Git、Node.js、Python、VS Code：可以在 Windows 设置的“应用”中卸载，也可以用 winget 手动卸载对应包。

如果只是想恢复 Claude 账号登录模式，不需要卸载 Claude Code，只需要运行菜单 6 后重新打开终端。

安全说明

  • 本工具不会上传你的 API Key。
  • 本工具不会打印完整 API Key。
  • API Key 只写入本机用户级环境变量。
  • 不要把 API Key 发给别人。
  • 不建议在共享电脑上保存 API Key。

更多内容见 SECURITY.md。

参考链接

免责声明

AI-Dev-Kit 只是环境安装和配置辅助工具，不破解 Claude，不绕过订阅，不伪造授权。使用第三方 API、安装第三方工具产生的费用、限制和风险，请以对应服务商的官方说明为准。

About

No description, website, or topics provided.

Resources

Readme

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages