🚀 AI 开发工具

Claude Code & Codex CLI - 安装与配置指南

✨ 三步上手 AI 开发工具
  1. 第一步:安装 - 选择你的系统,复制命令运行
  2. 第二步:配置 - 登录网站复制 API Key,粘贴到终端
  3. 第三步:测试 - 运行验证命令,开始使用

第一步:安装

🎯 快速下载脚本(推荐新手)

点击按钮直接下载安装/配置脚本,无需输入命令

下载后双击运行即可(Mac/Linux 需要先执行 chmod +x)

📦 macOS / Linux / WSL

适用于 Unix 系统

🪟 Windows

适用于 Windows 10/11

📝 下载后如何使用?
  • macOS/Linux: 下载后运行 chmod +x install.sh && ./install.sh
  • Windows: 下载后双击 install.bat 运行(或右键"以管理员身份运行")

💡 或者使用命令行方式(熟悉终端的用户推荐)

macOS / Linux / WSL

一键安装(推荐)
curl -fsSL https://visioncoder.cn/install.sh | bash
下载后安装
curl -O https://visioncoder.cn/install.sh
chmod +x install.sh
./install.sh

Windows (推荐 PowerShell)

下载并安装
Invoke-WebRequest -Uri "https://visioncoder.cn/install.bat" -OutFile "$env:TEMP\install.bat"
cmd /c "$env:TEMP\install.bat"
或直接下载
curl -O https://visioncoder.cn/install.bat
.\install.bat

Windows CMD (需注意编码)

一键安装(推荐)
chcp 65001 && curl -O https://visioncoder.cn/install.bat && install.bat
分步安装(备选)
chcp 65001
curl -O https://visioncoder.cn/install.bat
install.bat
⚠️ Windows 用户提示
  • 推荐使用 PowerShell,避免编码问题
  • CMD 用户:使用一键安装命令(已包含编码设置)

第二步:配置

📝 配置流程(只需 3 步)
  1. 运行配置命令 - 选择下方命令复制运行,脚本会自动打开浏览器
  2. 登录并复制 - 在 https://visioncoder.cn/key 登录账号,复制 API Key
  3. 粘贴完成 - 回到终端粘贴 API Key,配置自动完成

💡 选择你的系统平台,复制对应的命令运行

macOS / Linux / WSL

一键配置(推荐)
curl -fsSL https://visioncoder.cn/config.sh | bash
下载后配置
curl -O https://visioncoder.cn/config.sh
chmod +x config.sh
./config.sh
生效环境变量
source ~/.zshrc # 或 ~/.bashrc

Windows (推荐 PowerShell)

下载并配置
Invoke-WebRequest -Uri "https://visioncoder.cn/config.bat" -OutFile "$env:TEMP\config.bat"
cmd /c "$env:TEMP\config.bat"
或直接下载
curl -O https://visioncoder.cn/config.bat
.\config.bat

Windows CMD (需注意编码)

一键配置(推荐)
chcp 65001 && curl -O https://visioncoder.cn/config.bat && config.bat
分步配置(备选)
chcp 65001
curl -O https://visioncoder.cn/config.bat
config.bat

第三步:测试使用

✅ 运行以下命令验证安装是否成功

验证 Claude Code
claude --help
验证 Codex CLI(如果安装了)
codex --version
🎉 安装成功!

如果命令正常显示帮助信息或版本号,说明安装配置成功!

开始使用

验证成功后,直接在终端输入命令即可使用

使用 Claude Code
claude
使用 Codex CLI
codex
💡 使用提示
  • Claude Code:直接输入 claude 进入交互式对话
  • Codex CLI:直接输入 codex 启动代码助手
  • 输入命令后,按照提示操作即可开始使用

❓ 常见问题

1. 命令找不到(command not found)

解决方案
  • macOS/Linux:运行 source ~/.zshrcsource ~/.bashrc
  • Windows:关闭并重新打开命令提示符或 PowerShell
  • 如果还是不行,重新运行配置脚本

2. 如何更新 API Key?

只需重新运行配置脚本即可

脚本会自动检测并覆盖旧配置。

curl -fsSL https://visioncoder.cn/config.sh | bash

3. 可以只安装一个工具吗?

当然可以!

运行安装/配置脚本时,会出现选择菜单:

  • 只安装/配置 Claude Code
  • 只安装/配置 Codex CLI
  • 全部安装/配置(推荐)

4. Windows CMD 遇到乱码怎么办?

解决方案:
  • 推荐:使用一键命令(已包含编码设置)
  • 或使用 PowerShell 代替 CMD
  • 或手动运行 chcp 65001 切换到 UTF-8 编码

5. 安装的工具保存在哪里?

安装位置
  • 全局 npm 包:通过 npm install -g 安装
  • 配置文件:
    • Claude Code: 系统环境变量
    • Codex CLI: ~/.codex/ 目录

6. 如何卸载?

卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
卸载 Codex CLI
npm uninstall -g @openai/codex
删除配置文件(可选)
  • macOS/Linux:编辑 ~/.zshrc~/.bashrc,删除 # >>> CLAUDE ENV BEGIN >>># <<< CLAUDE ENV END <<< 之间的内容
  • Windows:在"环境变量"中删除 ANTHROPIC_AUTH_TOKENANTHROPIC_API_KEYANTHROPIC_BASE_URL
  • Codex:删除 ~/.codex/ 目录

7. 更多帮助

获取帮助

如果遇到其他问题,请访问: