← Volver a las guías

从零配置 iTerm2 与 Claude Code：59API 低成本生产力终端方案

先搭建一个适合长时间编程的 iTerm2

Claude Code 的效率很大程度取决于终端环境。macOS 用户可先通过 Homebrew 安装 iTerm2：brew install --cask iterm2；随后安装 Node.js LTS，再执行 npm install -g @anthropic-ai/claude-code，并用 claude --version 确认命令可用。iTerm2 中建议新建一个专用于 AI 开发的 Profile，字体选择等宽且字符覆盖完整的字体，例如 JetBrains Mono 或 MesloLGS NF，字号设为 14 至 16。这样文件树、差异输出和 Unicode 符号都更清晰。

在 Profiles 的 Text 中将行距略微提高，并开启足够大的 Scrollback buffer，便于回查 Claude Code 的操作记录。Colors 不必追求花哨，但应保证命令、错误和 git diff 的对比度。窗口建议采用深色背景、浅色前景，光标选择醒目的颜色；如果经常分屏，可把左右分屏快捷键设置为 Command+D、Command+Shift+D，分别用于运行测试、查看日志和与 Claude Code 交互。

整理 zsh：让项目切换和上下文更干净

iTerm2 默认通常使用 zsh。编辑 ~/.zshrc，保留简洁、可预测的配置：启用 git 分支提示，设置 history 的保存数量，并加入常用别名，例如 gs 对应 git status、gd 对应 git diff、ll 对应 ls -lah。不要在 shell 启动时运行耗时的网络命令，否则每次打开 Claude Code 都会变慢。修改后执行 source ~/.zshrc，再用 exec zsh 重启当前会话验证。

建议为每个项目使用独立目录，并在仓库根目录维护 CLAUDE.md。这个文件应写清楚技术栈、启动命令、测试命令、代码风格、禁止修改的目录和部署约束。Claude Code 会优先读取项目上下文，因此一份短而准确的 CLAUDE.md，通常比在对话中反复解释需求更可靠。开始工作前先执行 git status，重要任务使用 git worktree 创建隔离分支，避免 AI 修改与正在进行的人工改动互相干扰。

通过 59API 接入 Claude Code

59API 提供兼容 Claude Code 的 API 中转服务，基础地址为 https://api.59api.com。注册后在控制台创建 API Key，并按控制台提供的模型名称和接入说明配置环境变量。常见做法是在 ~/.config/claude/59api.env 中保存 ANTHROPIC_BASE_URL=https://api.59api.com，以及对应的认证令牌变量；再从 ~/.zshrc 中 source 该文件。保存密钥文件后执行 chmod 600 ~/.config/claude/59api.env，避免其他本机账户读取。

密钥不要写入 CLAUDE.md、项目 .env 示例文件、截图或 Git 提交记录。配置完成后，在一个非生产仓库运行 claude，要求它读取当前目录结构并总结测试命令，以验证网络、认证和上下文读取均正常。若出现 401，优先检查 API Key 是否过期、环境变量是否已重新加载，以及基础地址是否与 59API 控制台说明一致。

按任务选择模型并建立生产纪律

日常代码阅读、补全、小型重构可优先选用响应快、成本低的模型；复杂架构设计、跨文件调试和发布前审查再切换到更强模型。Claude Code 可通过其模型选择界面或启动参数使用已接入的模型，具体标识应以 59API 控制台展示为准。59API 提供 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型的按量计费访问，保持官方模型质量且价格较低，适合将高频探索与关键任务分层处理；其推荐返佣机制也适合团队共享成熟配置。

• 修改前：要求 Claude Code 先说明计划、影响文件和验证方式。
• 修改后：立即运行项目测试、类型检查或构建命令，不以“看起来正确”代替验证。
• 提交前：检查 git diff，特别关注依赖升级、权限配置、删除操作和环境变量。
• 成本控制：把大任务拆成可验证的小步骤，完成阶段目标后再开启下一轮上下文。

完成上述配置后，iTerm2 负责稳定、高可读的交互界面，zsh 负责快速进入项目，Claude Code 负责理解和执行开发任务，而 59API 则提供更灵活的低成本模型入口。需要长期使用 Claude Code 的开发者，可注册 59API 创建密钥后，从一个测试仓库开始验证自己的工作流。

Precios · Docs