← Retour aux guides

Claude Code 终端配置速通：iTerm2 换行、密钥与低成本接入

先选终端：顺手比折腾重要

如果你在 macOS 上从零开始，建议采用iTerm2＋现有命令行环境＋Claude Code，先跑通任务，再调整外观。不必为了使用 Claude Code 安装整套插件：官方说明它可以在任意终端运行，终端配置主要解决换行、按键和显示问题。已经用惯其他终端的开发者，也可以直接沿用。([code.claude.com](https://code.claude.com/docs/en/terminal-config))

第一步：安装并确认命令可用

已安装 Homebrew 的用户，在终端执行 brew install --cask claude-code，随后运行 claude --version。看到版本号，再进入项目目录启动，不要先花时间调主题。注意：Homebrew 安装不会自动更新，后续使用 brew upgrade claude-code 更新。([code.claude.com](https://code.claude.com/docs/en/quickstart))

显示方面，建议先用清晰的等宽字体、14—16 号字号和不透明背景，确保代码差异容易辨认。启动 Claude Code 后，通过 /config 选择与终端背景一致的明暗主题，避免浅色文字落在浅色背景上。([support.claude.com](https://support.claude.com/en/articles/14554000-claude-code-power-user-tips?utm_source=openai))

第二步：先修好换行，再配修饰键

在 Claude Code 输入框里测试两行文字：当前版本的 iTerm2 原生支持 Shift+Enter 换行，普通 Enter 用于提交。若换行异常，先用 Ctrl+J，或输入反斜杠后按 Enter，不要立即覆盖现有键位。VS Code 集成终端则可运行 /terminal-setup 配置换行。([code.claude.com](https://code.claude.com/docs/en/terminal-config))

需要 Option 组合键时，进入 iTerm2 的设置→配置文件→按键→通用，找到左右 Option 键选项，选择发送 Esc 前缀的模式，界面可能显示为 Esc+ 或 +Esc。不要误选旧式 Meta 模式：iTerm2 文档指出，它与现代系统不兼容。修改后重新测试常用快捷键。([iterm2.com](https://iterm2.com/documentation-preferences-profiles-keys.html))

第三步：用 59API 按量接入

终端解决交互，接口决定调用成本。59API 提供 Claude 与 GPT 的按量访问，兼容 Claude Code、Codex 和 OpenAI SDK，适合不想先承担固定订阅成本的个人项目。平台介绍覆盖 Opus、Sonnet、Haiku、Fable 等模型，并说明采用原生官方质量模型、不通过降级压低成本；实际模型、费率和额度应以控制台为准。([59api.com](https://59api.com/blog/5-claude-api-59api-3855?utm_source=openai))

取得 59API 密钥后，在 macOS 默认的 zsh 中依次执行下面三步。先只配置当前终端，验证成功后再考虑持久化：

• 清理旧密钥变量：执行 unset ANTHROPIC_API_KEY，避免遗留配置干扰本次测试。
• 设置接口：执行 export ANTHROPIC_BASE_URL='https://api.59api.com'。
• 隐藏输入密钥：执行 read -rs 'ANTHROPIC_AUTH_TOKEN?粘贴59API密钥后按回车：'; export ANTHROPIC_AUTH_TOKEN; echo。

这里使用的是 59API 展示的基地址与令牌配置方式；Claude Code 官方也支持通过 ANTHROPIC_BASE_URL 指定网关，通过 ANTHROPIC_AUTH_TOKEN 发送认证令牌。不要自行给基地址追加路径，也不要把密钥写进项目仓库或公开截图。([59api.com](https://59api.com/))

第四步：用一个小任务验收

进入自己的项目目录后执行 claude，先发送：“只阅读项目结构，说明启动命令和测试入口，不修改文件。”确认能够正常返回，再尝试范围明确的修改任务。官方快速入门同样采用在项目目录启动的方式。([code.claude.com](https://code.claude.com/docs/en/quickstart))

• 交互检查：两行提示能否保留换行，提交前是否容易检查内容。
• 连接检查：在 59API 控制台核对请求记录、所用模型和实际扣费。
• 权限检查：先阅读，再批准必要操作，不要为了省事放开全部权限。

建议用同一个小任务比较可用模型的结果和账单，而不是只看每百万令牌单价。若连接失败，按基地址、密钥、余额、模型 ID 的顺序核对，暂时不要同时修改终端和接口配置。

可选：使用 tmux 时再补配置

普通本地开发可以先跳过。如果外层 iTerm2 换行正常，进入 tmux 后却直接提交，在 ~/.tmux.conf 中逐行加入 set -g allow-passthrough on、set -s extended-keys on、set -as terminal-features 'xterm*:extkeys'，然后执行 tmux source-file ~/.tmux.conf 并重新启动 Claude Code。它们分别用于透传通知和保留扩展按键信息。([code.claude.com](https://code.claude.com/docs/en/terminal-config))

至此，最佳配置的标准很简单：换行可靠、文字清楚、密钥不外泄、账单可核对。如果你正在寻找低成本接入方式，可以注册 59API，用少量余额验证自己的真实任务；平台也提供推荐返利，具体规则以账户页面为准。([59api.com](https://59api.com/))

Tarifs · Docs