AI CLI设置库
🚀 使用Context7集成完成AI命令行界面的设置
快速开始
选项1:免费使用OpenAI Codex(推荐)
curl -fsSL https://raw.githubusercontent.com/barkleesanders/claude-zai-setup/main/setup.sh | bash -s -- --cli codex选项2:使用Google Gemini CLI免费
curl -fsSL https://raw.githubusercontent.com/barkleesanders/claude-zai-setup/main/setup.sh | bash -s -- --cli gemini选项3:使用Claude Code+z.ai支付保费(约3美元/月)
curl -fsSL https://raw.githubusercontent.com/barkleesanders/claude-zai-setup/main/setup.sh | bash -s -- --cli claude选项4:带有Conductor.build+Claude Code的桌面应用程序(约3美元/月)
curl -fsSL https://raw.githubusercontent.com/barkleesanders/claude-zai-setup/main/setup.sh | bash -s -- --cli conductor这设置了什么
选择您喜欢的AI CLI:
免费选项
- OpenAI Codex命令行界面 -免费使用OpenAI API密钥,非常适合执行编码任务
- 谷歌Gemini CLI -使用Google AI API密钥免费,非常适合一般帮助
高级选项
- 克劳德代码CLI -Anthropic与z.ai API的官方命令行界面(约3美元/月)
- 导体建筑 -用于使用z.ai API管理多个Claude Code实例的桌面应用程序(每月约3美元)
通用组件
- Context7 MCP服务器 -自动搜索文档和库(免费版可用)
先决条件
- 已安装Node.js和npm
- GitHub CLI(gh)已安装并通过身份验证
- Shell(zsh或bash)
手动设置说明
您可以手动设置每个AI CLI,也可以使用免费的AI助手来帮助完成此过程!
选项1:免费OpenAI Codex设置(推荐)
- 获取OpenAI API密钥:
- 访问 https://platform.openai.com/api-keys - 创建API密钥 - 添加账单信息(必填)
- 安装OpenAI Codex CLI:
npm install -g @openai/codex- 配置环境:
echo 'export OPENAI_API_KEY="your_openai_key"' >> ~/.zshrc
source ~/.zshrc- 测试设置:
codex "Hello, explain React hooks"选项2:免费谷歌Gemini设置
- 获取Gemini API密钥:
- 访问 https://makersuite.google.com/app/apikey - 创建API密钥 - 在Google云控制台中启用Gemini API
- 安装Gemini CLI:
npm install -g @google/generative-ai-cli- 配置环境:
echo 'export GEMINI_API_KEY="your_gemini_key"' >> ~/.zshrc
source ~/.zshrc- 测试设置:
gemini "Explain JavaScript promises"选项3:高级克劳德代码+z.ai设置(约3美元/月)
- 获取z.ai API密钥:
- 访问 https://z.ai - 注册并购买 月度编码计划 (~$3) - 复制API密钥
- 安装Claude Code命令行界面:
npm install -g @anthropic-ai/claude-code- 配置环境:
echo 'export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_zai_key"' >> ~/.zshrc
source ~/.zshrc- 测试设置:
claude prompt "Explain microservices architecture"选项4:高级指挥家。构建+克劳德代码设置(约3美元/月)
- 安装Conductor。构建桌面应用程序:
- 访问 https://conductor.build - 下载并安装Mac桌面应用程序 - 从“应用程序”文件夹启动应用程序
- 获取z.ai API密钥:
- 访问 https://z.ai - 注册并购买 月度编码计划 (~$3) - 复制API密钥
- 安装Claude Code命令行界面(必填):
npm install -g @anthropic-ai/claude-code- 配置环境:
echo 'export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_zai_key"' >> ~/.zshrc
source ~/.zshrc- 测试设置:
claude prompt "Hello, test connection"- 使用导线。构建:
- 启动Conductor.build从应用程序 - 打开您的项目存储库 - 并行创建多个Claude Code实例 - 每个实例都有一个独立的git工作树
可选:Context7文档搜索(所有CLI)
- 获取上下文7 API密钥:
- 访问 https://context7.com - 注册并导航到 MCP服务器 章节 - 生成API密钥
- 安装克劳德代码(如果尚未安装):
npm install -g @anthropic-ai/claude-code- 配置Context7 MCP:
claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: your_context7_key"🤖 获得免费AI助手的帮助
如果您在设置过程中遇到问题,您可以使用免费的AI CLIs来帮助您:
使用OpenAI Codex获取帮助
# Install Codex first
npm install -g @openai/codex
# Get help with setup issues
codex "I'm getting a permission denied error when running npm install -g, how can I fix this?"
# Debug environment variables
codex "Help me debug why my OPENAI_API_KEY isn't being loaded in my shell"
# Explain technical concepts
codex "What's the difference between ~/.zshrc and ~/.bashrc?"使用Google Gemini寻求帮助
# Install Gemini first
npm install -g @google/generative-ai-cli
# Get troubleshooting assistance
gemini "My CLI tool isn't working after installation, what should I check?"
# Understand configuration
gemini "Explain how to properly set up environment variables in macOS"
# Get coding help
gemini "Show me how to create a simple shell script for managing API keys"自动设置脚本
对于自动设置,克隆此存储库并运行脚本:
# Clone this repository
git clone https://github.com/barkleesanders/claude-zai-setup.git
cd claude-zai-setup
# Make script executable and run with your preferred CLI
chmod +x setup.sh
./setup.sh --cli codex # Free OpenAI setup
./setup.sh --cli gemini # Free Google setup
./setup.sh --cli claude # Premium Claude setup
./setup.sh --cli conductor # Desktop app setup脚本将:
- 如果不存在,请安装所选的AI CLI
- 提示输入带有验证的API密钥
- 在shell配置文件中配置环境变量
- 设置Context7 MCP服务器(用于Claude)
- 测试安装
- 如果安装失败,请提供帮助选项
用法
克劳德代码(z.ai设置)
设置后,您可以通过两种方式使用Claude Code:
交互模式
claude单一提示
claude prompt "Explain React hooks"使用Context7文档搜索
Claude现在可以自动搜索并包含相关文档:
claude prompt "How do I implement form validation with React Hook Form?"OpenAI Codex(免费设置)
codex "Explain React hooks"
codex "Help me debug this JavaScript code"谷歌双子座(免费设置)
gemini "Explain microservices architecture"
gemini "Show me how to optimize Python performance"Conductor.build(桌面应用程序)
# Launch Conductor.build from Applications folder
# Open your project repository
# Create multiple Claude Code instances for parallel work
# Each instance gets an isolated git worktree
# Use Claude CLI directly when needed:
claude prompt "Help me debug this issue"环境变量
安装脚本将这些添加到您的shell配置文件中(~/.zshrc 或 ~/.bashrc):
适用于克劳德代码+z.ai
# z.ai Anthropic configuration
export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"OpenAI Codex
# OpenAI API configuration
export OPENAI_API_KEY="your_openai_api_key"Google Gemini
# Gemini API configuration
export GEMINI_API_KEY="your_gemini_api_key"适用于导线。建筑+克劳德规范
# z.ai Anthropic configuration (for Conductor.build)
export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"验证安装
# Check Claude CLI version
claude --version
# Check MCP server status
claude mcp list
# Test with a simple prompt
claude prompt "Hello, world!"故障排除
GitHub CLI权限
如果遇到工作流权限错误:
gh auth refresh --hostname github.com --scopes gist,read:org,repo,workflowMCP服务器问题
# Check MCP server health
claude mcp list
# Remove and re-add Context7 if needed
claude mcp remove context7
claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: your_key"Conductor.build身份验证问题
如果Conductor.build显示“您的帐户无法访问克劳德代码”:
# Make sure environment variables are loaded
source ~/.zshrc # or ~/.bashrc
# Verify z.ai configuration
echo $ANTHROPIC_BASE_URL # Should show: https://api.z.ai/api/anthropic
echo ${#ANTHROPIC_AUTH_TOKEN} # Should show: 49
# Launch Conductor from terminal with environment loaded
open /Applications/Conductor.app
# Or restart your terminal and launch Conductor again重要提示: Conductor.build需要从shell继承环境变量。在启动Conductor之前,始终启动一个新的终端或源shell配置文件。
壳牌问题
如果未加载环境变量:
# Reload shell configuration
source ~/.zshrc # or ~/.bashrc成本信息
- z.ai月度编码计划:约3美元/月(原价折扣)
- 导体建筑:免费桌面应用程序(需要z.ai订阅)
- OpenAI API:按需付费(提供免费套餐,然后根据使用情况付费)
- Google Gemini API:按需付费(慷慨的免费等级,然后基于使用情况)
- 背景7:免费套餐可用,大量使用付费套餐
- 克劳德代码:免费CLI工具
安全
- API密钥存储在外壳配置文件的本地
- 此存储库中没有公开密钥
- 脚本在使用前验证API密钥格式
- 钥匙不会被记录或传输到任何地方
链接
- 导体建筑 -用于管理多个Claude Code实例的桌面应用程序
- z.ai -经济实惠的人工智能API提供商
- 背景7 -文档搜索服务
- Claude代码文档
- OpenAI平台 -OpenAI API和Codex CLI
- 谷歌AI工作室 -Gemini API访问
许可证
MIT许可证-您可以根据需要自由使用和修改。
