← Voltar aos guias

Claude Code in iTerm2: Setup Fixes That Actually Help

What is the best terminal setup for Claude Code?

On macOS, iTerm2 is a practical choice for Claude Code: it offers profiles, split panes, configurable keyboard shortcuts, and searchable scrollback. Start with a current iTerm2 release, a readable font, and working multiline input. Add tmux only if you need persistent sessions; extra terminal layers introduce more places for keyboard and display settings to conflict.

Use one pane for Claude Code and another for tests, logs, or Git commands. This keeps the conversation visible while you verify changes independently.

How do I install and launch Claude Code?

Install Claude Code using its native macOS installer: curl -fsSL https://claude.ai/install.sh | bash. Open a new terminal afterward, then run claude --version to confirm the command is available.

Move into your project with cd /path/to/project, then launch claude. Starting from the project directory gives Claude the right working context. Review permission requests before allowing commands or file changes.

• Command not found: Check whether ~/.local/bin is on your PATH. For the current session, run export PATH="$HOME/.local/bin:$PATH". Add that line to your shell configuration if needed.
• Installation or environment problems: Run claude doctor to inspect the installation and follow its diagnostics.

Why does Enter submit instead of adding a newline?

Enter normally submits your message. Inside Claude Code, run /terminal-setup to configure the supported iTerm2 multiline shortcut, then test Shift+Enter with a short prompt. Shortcut support can vary with your Claude Code and terminal versions.

The reliable fallback is to type a backslash immediately before pressing Enter. Claude Code treats that sequence as a newline, so you can compose a longer request without submitting each line.

If Shift+Enter still fails, inspect iTerm2’s profile-specific key mappings and global key mappings for an existing assignment. Also check macOS keyboard utilities that intercept shortcuts. Test outside tmux first: if the shortcut works there, the extra terminal layer is where you should investigate.

Which iTerm2 settings improve readability?

• Font: Choose a familiar monospace font at roughly 13–15 points. A special icon font is optional.
• Contrast: Use a theme with clearly distinguishable text, selections, and command output. Disable transparency if background windows reduce readability.
• Scrollback: Set a generous limit in your profile’s Terminal settings so you can review longer command output.
• Window size: Give Claude enough width to display file paths and diffs without excessive wrapping.

If colors or line drawing look broken, inspect echo $TERM. A normal iTerm2 session commonly reports xterm-256color; tmux may use a different valid value. Avoid forcing one TERM value globally, because it should describe the terminal actually providing the session.

How do I connect Claude Code to 59API?

59API provides low-cost, pay-as-you-go access to Claude and GPT models, with compatibility for Claude Code, Codex, and OpenAI SDKs. For Claude Code, use its Anthropic-compatible connection settings; OpenAI SDK configuration belongs in clients using that API format.

Get your key and confirm the authentication method in the 59API dashboard. Set export ANTHROPIC_BASE_URL="https://api.59api.com". If the dashboard specifies bearer-token authentication, set export ANTHROPIC_AUTH_TOKEN="YOUR_59API_KEY". If it specifies API-key authentication, use ANTHROPIC_API_KEY instead. Avoid leaving conflicting credentials active.

Launch Claude from that same shell so it inherits the variables. These exports last for the current session. For persistent access, use a protected local configuration or credential manager, and keep credentials out of Git and screenshots.

Why am I seeing authentication, model, or rate-limit errors?

• 401 or 403: Check the key, authentication method, account status, and whether Claude inherited the intended environment.
• Model unavailable: Use the exact model identifier listed by 59API. Confirm access before selecting it with /model.
• 429: Check balance, concurrency, and rate limits. Repeated immediate retries can prolong the problem.

Is 59API a good choice for everyday coding?

Its pay-as-you-go pricing suits developers who want affordable access without committing to a fixed monthly subscription. 59API offers native, official-quality models without downgrading, plus a referral rebate. Compare current model rates against your workload, especially for long coding sessions. Sign up for 59API and start with a small coding task to check compatibility and actual spend.

Preços · Docs